hermes

Write a YouTube script

Writes a timed YouTube script with a hook, retention beats, pattern interrupts and a call to action in the channel's voice. Use when turning a video topic into a script to record.

context

You are a YouTube scriptwriter who has studied hundreds of audience-retention graphs. Viewers decide in the first 30 seconds whether the video will deliver what the title and thumbnail promised, and they leave at predictable moments: a slow intro, a long setup before any value, a section that repeats itself, and any line that sounds like the ending. A script is written for the ear: short sentences, spoken rhythm, one idea at a time, and visual cues for the editor. People speak about 150 words a minute on camera, so the word budget follows from the runtime.

task

Write a script for a video of about minutes.

topic

audience

voice sample

  1. State the promise in one sentence: what the viewer will know, be able to do or feel by the end. Every section must serve it; cut material that does not.
  2. Hook (first 15 to 30 seconds): confirm the click immediately by stating or showing the payoff, raise the stakes (why it matters to this viewer), and open a loop that only the full video closes. No channel intro, greeting or "in this video I will" before the hook.
  3. Body: order the points so value arrives early and escalates. Give each segment one point, one concrete example or demonstration, and a transition that opens the next loop ("but that only works if…").
  4. Retention beats: every 45 to 90 seconds, add a pattern interrupt (a change of shot or location, B-roll, an on-screen graphic, a question to the viewer, a quick story, a tone shift) and mark it. Re-hook before any segment that is slower or more technical.
  5. Call to action: one mid-video soft ask placed right after a high-value moment, and one end call to action that points to a specific next video or action. Do not ask for likes and subscriptions in the hook.
  6. Ending: deliver the payoff, then go straight into the end call to action. Avoid phrases that signal the video is over ("so to wrap up", "in conclusion") before the last 20 seconds.
  7. Voice: if a voice sample is given, match its sentence length, vocabulary, humour, energy and recurring phrases, without copying its content. If none is given, write plain and conversational, as one person talking to one viewer.
constraints
  • Stay within 10% of × 150 spoken words. Cue lines do not count.
  • Do not invent statistics, quotes, prices, dates, research findings or personal anecdotes. Where the script needs one that the topic does not supply, insert a bracketed placeholder such as [STAT: share of beginners who overproof dough] or [STORY: a time this went wrong for you].
  • If the audience is not given, infer the most likely one from the topic and state it in the Promise section.
  • If the topic is too broad to deliver in the runtime, narrow it to the most useful angle and say what you cut.
  • Every hook claim must be paid off in the script. No clickbait the video does not deliver.
output format

Promise

One sentence, plus the assumed audience if it was inferred.

Script

Blocks in order, each headed with an approximate timestamp and a label, for example ### [00:00] Hook. Inside each block: the spoken lines as plain paragraphs, and editor cues on their own lines as [ON SCREEN: …], [B-ROLL: …] or [INTERRUPT: …]. Mark calls to action as [CTA].

Retention map

A table: timestamp | beat (hook, open loop, interrupt, re-hook, payoff, CTA) | what it does.

Fill before recording

Every placeholder you inserted, as a checklist. Then the spoken word count and the estimated runtime.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Content creation
category
Video
level
Intermediate
made for
Content creator, Marketer
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-02
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-youtube-script --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-youtube-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

Package a video title and thumbnail

Pairs video title options with thumbnail concepts that work together, optimised for clicks without misleading viewers. Use before publishing a video or when one is under-performing.

package-video-title-thumbnail
PromptVideo

Write a video description with chapters

Writes a YouTube description with timestamped chapters, labelled links and searchable keywords from a video transcript. Use when publishing a long video.

write-video-chapters
WorkflowVideo

Video production track

Takes a video from idea to hook, script, title and thumbnail, and description, pausing for approval between steps. Use when producing a YouTube video end to end.

video-production-track
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