Explainer
Build a large, custom, discardable artifact whose only job is to make one topic understood.
Pick the mode
Ask every time, before any research or drafting, even when the request names a format. Use one single-select question with Web page, Video, and Technical description as the options, then wait for the answer. If the request names a format, list that option first.
- Web page. Named by "in HTML", "web page", or "interactive". Read
references/web.md.
- Video. Named by "video", "3b1b", "animated video", or "narrated". Read
references/video.md.
- Technical description. Named by "STE", "ASD-STE100", "Simplified Technical English", "technical description", or "description and operation". Read
references/technical.md.
Rules for all modes
- Pin the one sentence the viewer should leave with and the audience level. Infer both from the request. Ask only when the audience would change the content.
- Establish the facts before drafting. Use supplied material first. Verify facts that change over time. Separate facts, interpretations, unknowns, and examples. Cite as the mode file says. Video narration cannot carry links, so list its sources in the handoff.
- Label illustrative data as illustrative.
- Order the ideas: a question or puzzle, one concrete example, the mechanism, the general rule, a one-line recap. Technical description uses the section order in
references/technical.md instead.
- Show, then say. Every beat has one visual that carries the idea. Text and narration support the visual, not the reverse. Technical description uses the figure count in
references/technical.md instead.
- Read
references/writing.md before writing narration or page text. Define each term on first use. Technical description applies the full standard in references/technical.md instead.
- Draw diagrams, labels, and equations with code. Never use image or video generation for them, because generated media cannot render exact labels.
- Use the shared dark theme.
templates/page.html and templates/explainer_scene.py hold the same dark palette, role colors, and PPLX type from assets/fonts/. The page adds a light variant behind a toggle. After editing either file, run python scripts/test_theme_parity.py from this skill directory. Technical description takes its theme from templates/page.html when scripts/build_technical.py runs.
Deliver
- Report the actual result of the mode's Check list and its limits. Never infer browser verification from code inspection.
- List any claim you could not verify.
- Never call output STE compliant, certified, or ASD approved. In Technical description mode, say that a script examined the page and that ASD did not.
- When the execution target is a RemoteBox, the website deploy tool is unavailable there (seen 2026-10-12). Copy the built page to the Cloud sandbox with the file-copy tool, switch to Cloud, deploy, then switch back.
1---2name: explainer3description: "Build a bespoke explainer as an interactive HTML page, a narrated 3Blue1Brown-style video, or an ASD-STE100 technical description page. Invocation-only. Use for /explainer, $explainer, or an explicit request to use the explainer skill. Not for quick inline charts, ELI5 chat answers, product demo videos, or /explain lessons."4metadata:5 version: '0.15.0'6 source: https://skillmd.com/skills/mattdweigand-sketch/explainer7 upstream: https://x.com/karpathy/status/21058193034719764798 owner: Matt Weigand9 last-reviewed: '2026-10-12'10 review-when: "The TTS model changes, Manim moves past 0.21, the platform video tools change, the PPLX fonts in assets/fonts change, or a new ASD-STE100 issue replaces Issue 9."11---1213# Explainer1415Build a large, custom, discardable artifact whose only job is to make one topic understood.1617## Pick the mode1819Ask every time, before any research or drafting, even when the request names a format. Use one single-select question with **Web page**, **Video**, and **Technical description** as the options, then wait for the answer. If the request names a format, list that option first.2021- **Web page.** Named by "in HTML", "web page", or "interactive". Read `references/web.md`.22- **Video.** Named by "video", "3b1b", "animated video", or "narrated". Read `references/video.md`.23- **Technical description.** Named by "STE", "ASD-STE100", "Simplified Technical English", "technical description", or "description and operation". Read `references/technical.md`.2425## Rules for all modes26271. Pin the one sentence the viewer should leave with and the audience level. Infer both from the request. Ask only when the audience would change the content.282. Establish the facts before drafting. Use supplied material first. Verify facts that change over time. Separate facts, interpretations, unknowns, and examples. Cite as the mode file says. Video narration cannot carry links, so list its sources in the handoff.293. Label illustrative data as illustrative.304. Order the ideas: a question or puzzle, one concrete example, the mechanism, the general rule, a one-line recap. Technical description uses the section order in `references/technical.md` instead.315. Show, then say. Every beat has one visual that carries the idea. Text and narration support the visual, not the reverse. Technical description uses the figure count in `references/technical.md` instead.326. Read `references/writing.md` before writing narration or page text. Define each term on first use. Technical description applies the full standard in `references/technical.md` instead.337. Draw diagrams, labels, and equations with code. Never use image or video generation for them, because generated media cannot render exact labels.348. Use the shared dark theme. `templates/page.html` and `templates/explainer_scene.py` hold the same dark palette, role colors, and PPLX type from `assets/fonts/`. The page adds a light variant behind a toggle. After editing either file, run `python scripts/test_theme_parity.py` from this skill directory. Technical description takes its theme from `templates/page.html` when `scripts/build_technical.py` runs.3536## Deliver3738- Report the actual result of the mode's Check list and its limits. Never infer browser verification from code inspection.39- List any claim you could not verify.40- Never call output STE compliant, certified, or ASD approved. In Technical description mode, say that a script examined the page and that ASD did not.41- When the execution target is a RemoteBox, the website deploy tool is unavailable there (seen 2026-10-12). Copy the built page to the Cloud sandbox with the file-copy tool, switch to Cloud, deploy, then switch back.