executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available
narration-scriptWrite the spoken voiceover for a tutorial or demo - the actual words, phrased for the ear and synced one-instruction-per-action to what is on screen, with a pacing budget and a confident, jargon-checked tone. Use when someone says "write the voiceover", "script the narration", "what should I say over this", "VO script for my tutorial", "narrate this demo", …
Independent GitHub snapshot · Automated classification · Original documentation governs
name: narration-script description: Write the spoken voiceover for a tutorial or demo - the actual words, phrased for the ear and synced one-instruction-per-action to what is on screen, with a pacing budget and a confident, jargon-checked tone. Use when someone says "write the voiceover", "script the narration", "what should I say over this", "VO script for my tutorial", "narrate this demo", "the script feels robotic", or "the narration is too wordy". Do NOT use to mix, time, duck, source, or beat-match the audio - VO leveling, SFX, music - that is sound-and-music-sync; do NOT use to decide which scenes exist or their order - that is video-storyboard; do NOT use to direct the on-screen actions themselves (cursor, zoom, callouts) - that is product-demo-director; do NOT use to turn spoken lines into animated on-screen text - that is kinetic-typography.
A tutorial lives or dies on its narration. The viewer is trying to do the thing while listening, so every word competes with their attention on the screen. Write less, say it plainer, and pin each line to a visible action.
Spoken language is not written language. Read every line aloud before keeping it.
The cardinal rule: one instruction per on-screen action, and the words land with the action, never describing what already happened.
A reliable three-part shape per step keeps viewers oriented:
Signpost between steps with light transitions - "Next", "Now that the link exists, let's…" - so the spine of the tutorial is always audible.
Confident and warm, like a competent colleague sitting beside them. Never condescending, never hype. Define a term the first time it appears, then use it consistently. Match on-screen UI labels exactly - if the button says "New project", say "New project", not "create a project."
Deliver a two-column script the editor and VO talent can both follow:
| On-screen action | Spoken line |
|---|---|
| Cursor opens Share menu | "Open the Share menu in the top right." |
| Link toggles to public | "Switch it to Anyone with the link." |
Mark [pause] where the visual should carry the moment, and bold the words to stress. Note approximate timing per line if the storyboard durations are known.