Help us improve
Share bugs, ideas, or general feedback.
Writes narration scripts for documentary animated explainer sequences with paired visual direction cues, ready for narrator and animation team briefs.
npx claudepluginhub ur-grue/autopunk-media-skills --plugin autopunk-media-skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/autopunk-media-skills:animated-explainer-scriptThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Writes a narration script for a documentary's animated explainer sequence — visual direction cues on each beat, ready to hand to the narrator and animation team.
Writes a timed, scene-by-scene narration script for an animated explainer video, matched to a specified duration and keyed to on-screen visual cues.
Creates animated explainer videos with Kurzgesagt-inspired style using Remotion. Handles storyboarding, SVG animation, narration generation via edge-tts, and video rendering.
Generates YouTube video scripts, teleprompter text, or structured bullet points from outlines, including hooks, transitions, CTAs, visual cues, and timing estimates.
Share bugs, ideas, or general feedback.
Writes a narration script for a documentary's animated explainer sequence — visual direction cues on each beat, ready to hand to the narrator and animation team.
Required:
Optional:
Identifies the explanation structure. Every explainer needs a logic: chronological (first this, then this), causal (this causes that), comparative (A versus B), or process-based (step 1, step 2, step 3). The assistant determines which structure best serves the concept and uses it to organise the sequence.
Writes the narration script. Drafts voiceover text at approximately 150 words per minute of target duration — the standard pace for documentary narration that allows breathing room for the visuals to land. The language is concrete and specific: no jargon without immediate plain-language follow-through, no passive constructions when active voice is clearer, no more than one new concept per sentence.
Adds visual direction cues for every beat. Each section of narration is paired with a [VISUAL] cue that describes what the viewer should see on screen at that moment. These cues are written for an animation team — they describe the visual action, the data being shown, the movement or transition, and any on-screen text. They are not shot-by-shot storyboards, but they are specific enough for a motion graphics artist to begin work without a separate briefing document.
Builds in pacing. Inserts deliberate pauses — marked as [PAUSE — 1 sec] or [BEAT] — at moments where the visual needs to land before the narration continues. Complex graphics need time to resolve on screen before the narrator moves on. The script respects this by leaving space.
Opens and closes the sequence cleanly. The first line connects to the documentary's narrative (a question, a statement of stakes, or a transition from a previous scene). The last line delivers the takeaway — the single thing the viewer should retain — and provides a bridge back to the live-action film.
Two-column script format. Left column: narration text (what the narrator says). Right column: visual direction (what appears on screen). Each row represents one beat — typically 10–20 seconds of screen time. Total length matches the target duration at ~150 words per minute narration pace. Includes timing estimates per beat. Ends with a "Production Notes" section (2–3 bullets) covering any considerations for the animation team or narrator.
ANIMATED EXPLAINER — [Sequence Title]
Target duration: [X:XX] | Narration word count: [XXX]
| NARRATION | VISUAL DIRECTION |
|-----------|-----------------|
| [Text — Beat 1] | [Visual cue — Beat 1] |
| [Text — Beat 2] | [Visual cue — Beat 2] |
| ... | ... |
PRODUCTION NOTES
- [Note 1]
- [Note 2]
Concept: How microplastics enter the human food chain — from ocean pollution to dinner plates. The viewer should understand the three main pathways: direct ingestion by marine life, bioaccumulation up the food chain, and contamination of drinking water supplies. Duration: 2 minutes (approximately 120 seconds) Audience: General public, no prior knowledge assumed Tone: Accessible/educational — serious subject, but not alarmist Visual style: Clean infographic with a muted colour palette Context: This sequence follows an interview with a marine biologist who has just said, "People think this is an ocean problem. It's a kitchen problem." The sequence should pick up from that line.
ANIMATED EXPLAINER — Microplastics: Ocean to Plate Target duration: 2:00 | Narration word count: ~290
| NARRATION | VISUAL DIRECTION |
|---|---|
| Every year, roughly eight million tonnes of plastic waste enters the world's oceans. Most of it doesn't stay in the form you'd recognise. | Wide shot: globe with ocean highlighted. Plastic debris icons flow from coastlines into the water. Zoom in as large plastic items break apart into smaller and smaller fragments. On-screen text: "8 million tonnes / year." |
| Sunlight, salt water, and wave action break it down into fragments smaller than five millimetres. These are microplastics — and they're now in virtually every marine environment on earth. | Close-up: a single plastic fragment splitting into dozens of tiny particles. Scale bar appears showing "< 5mm." Particles disperse across the ocean cross-section. |
| [PAUSE — 1 sec] | Transition: ocean cross-section resolves. Three pathway icons appear at the bottom of screen, numbered 1, 2, 3. |
| The first pathway is direct. Small fish and shellfish mistake microplastics for food. A single mussel can contain dozens of particles. | Pathway 1 highlights. Animated fish and mussels with microplastic particles visible inside them. On-screen text: "Pathway 1 — Direct Ingestion." |
| The second pathway is accumulation. Small fish are eaten by larger fish. The plastics don't break down — they concentrate. A tuna at the top of the food chain carries the combined load of everything beneath it. | Pathway 2 highlights. Simple food chain diagram: plankton → small fish → medium fish → tuna. Particle count visibly increases at each level. On-screen text: "Pathway 2 — Bioaccumulation." |
| [BEAT] | Tuna icon pulses with accumulated particles. |
| The third pathway bypasses the ocean entirely. Microplastics are now found in tap water, bottled water, and agricultural soil irrigated with recycled wastewater. | Pathway 3 highlights. Split screen: tap with water flowing, water bottle, farmland with irrigation. Particles visible in all three. On-screen text: "Pathway 3 — Water & Soil Contamination." |
| [PAUSE — 1 sec] | All three pathways visible simultaneously. Lines converge toward a single dinner plate at the centre of the frame. |
| All three pathways lead to the same place. Current research estimates that the average person may ingest up to five grams of microplastic per week — roughly the weight of a credit card. | Dinner plate fills the frame. Fork and knife appear. On-screen text fades in: "Up to 5g per week." A credit card icon appears beside the plate for scale comparison. |
| The science on health effects is still emerging. What is not in question is the route: from ocean, to food chain, to you. | Plate and credit card fade. Final frame: the three pathway icons return, connected by a single line ending at a simple human figure silhouette. Clean, still, no animation — let the image sit. |
PRODUCTION NOTES