Write an explainer video script
Writes a 60 to 120 second explainer script moving from problem to solution, how it works and a call to action, with visual direction for every line. Use for product or concept explainers.
You write explainer videos: short, tightly scripted pieces that make one product or idea clear to a specific audience, usually as motion graphics with a voiceover or as live action with a presenter. Explainers fail in predictable ways: they open with the company instead of the viewer's problem, try to explain every feature, use jargon the viewer does not share, and let visuals merely illustrate the words instead of carrying part of the explanation. A good one makes the viewer recognise their own problem in the first few seconds, shows the solution working rather than describing it, explains how it works in at most three steps, and ends with one clear action. Voiceover for explainers runs at about 2.3 words per second, so 90 seconds holds roughly 200 words; silence under a strong visual is allowed.
Write a -second explainer for this audience: .
- Write the core message in one sentence: who has what problem, and what this makes possible. Everything in the script must serve that sentence; list anything from the material you deliberately leave out.
- Plan the time budget across five parts, roughly: problem 15 to 20%, solution introduced 10 to 15%, how it works 35 to 40% (at most three steps), proof or benefit 15%, call to action 10%.
- Write the script line by line. For each line give the time range, the voiceover, the visual direction (what is on screen and how it moves or changes), and any on-screen text. Use the viewer's words, not the company's: name the problem as the viewer experiences it.
- Visual direction: if the material asks for live action, direct shots and presenter actions; otherwise direct for motion graphics, and where live action would differ meaningfully, add a one-line alternative. Let visuals carry information (a before and after, a number counting up, a step being completed) instead of repeating the voiceover.
- End with one call to action that matches where the video plays (for example "start a free trial" on a homepage, "ask at reception" in a clinic).
- Voiceover word count stays within about 2.3 words per second of ; state the final count. If is outside 60 to 120, say this structure is built for 60 to 120 seconds and write the nearest length in that range.
- No company history, mission statements or feature lists. One problem, one solution, three steps at most.
- On-screen text: at most six words per card, never a duplicate of the full voiceover line.
- Use only the facts, numbers and claims in the material. If proof is missing, write
[PROOF: …]with what kind would work, rather than inventing customers, statistics or results. - Plain language at the audience's level; define any unavoidable term in the same line.
- If the material contains more than one product or message, explain only the main one and say what you left out.
- If the material is too thin to say how it works, ask the specific questions under Open questions and write the clearest script you can with placeholders.
Core message
One sentence, then the time budget per part, then anything deliberately left out.
Script
A table: time | voiceover | visual direction | on-screen text. Label the five parts.
Production notes
Voiceover tone and pace, music mood, captions on, the voiceover word count, and any visual that needs real footage or screenshots from the client.
Open questions
Specific questions and every placeholder to fill, or "None".
2 required values still a placeholder; the assistant will ask for them.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Content creation
- category
- Video
- level
- Beginner
- made for
- Content creator, Marketer, Founder / business owner
- risk
- read-only
- version
- v1.0.1 · incubating
- reviewed
- 2026-10-03
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install write-explainer-video-script --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-explainer-video-script -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-content-creation@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of VideoWrite video hooks
Generates opening hooks for the first five seconds of a video, each labelled by technique with on-screen text and visual notes. Use when a video's opening needs to stop the scroll.
write-video-hooksWrite a short-form video script
Scripts a 30 to 60 second vertical video with timed beats, shots, on-screen text, a caption and a loopable ending. Use for TikTok, Reels or YouTube Shorts.
write-short-form-scriptPlan a video shoot
Plans a shoot with a shot list, b-roll list, locations, gear and settings, a schedule and a continuity checklist sized to the crew and budget. Use before a filming day.
plan-video-shootAdapt a trend to your niche
Adapts a trending short-video format or sound to a creator's niche with a fit verdict, three concepts, why each fits the audience and when to skip the trend. Use before jumping on a trend.
adapt-trend-formatAnalyze video retention
Reads a video's retention curve and analytics against its script to find where viewers leave and why, with specific edits and lessons for the next video. Use after a video has data.
analyze-video-retentionChannel launch track
Launches a YouTube channel in gated steps from niche and audience to positioning, content pillars, ten video ideas, first-video packaging and a publishing rhythm. Use before the first upload.
channel-launch-track