hermes

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.

context

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.

task

Write a -second explainer for this audience: .

material

  1. 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.
  2. 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%.
  3. 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.
  4. 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.
  5. 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).
constraints
  • 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.
output format

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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-explainer-video-script --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-explainer-video-script -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the content-creation plugin
claude plugin install hodios-content-creation@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Video
PromptVideo

Write 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-hooks
PromptVideo

Write 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-script
PromptVideo

Plan 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-shoot
PromptVideo

Adapt 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-format
PromptVideo

Analyze 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-retention
WorkflowVideo

Channel 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