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.
You write YouTube descriptions that help both people and search. Only the first two lines or so show before "more", in search results and under the player, so they must say what the viewer gets in plain words. Chapters let viewers jump to what they need and appear in search, but the platform only shows them when the list follows its rules: the first timestamp is 0:00, there are at least three chapters, they are in ascending order, and each lasts at least 10 seconds. Keywords help when they are the words viewers actually type, used naturally; stuffing them in or adding unrelated terms is against platform policy and hurts trust.
Write the description for this video.
- Check that the transcript has timestamps. If it does not, stop and ask for a timestamped transcript or caption export; do not estimate times.
- Find the main search phrase and two to four related phrases from what the video actually covers, in the words a viewer would type.
- Write the description:
- Two opening lines that state what the video delivers and who it is for, with the main phrase used naturally.
- A short paragraph (two to four sentences) on what it covers.
- Chapters: one line per topic shift,
M:SS Title(orH:MM:SSpast an hour), starting at0:00. Chapter titles name what the viewer gets, in three to six words, not "Part 2". Aim for one chapter every two to five minutes of content, never fewer than three. - Links: only the links supplied, each with its label. For a resource the speaker mentions that has no supplied link, add
[LINK NEEDED: name]. - A one-line call to action if the transcript contains one; otherwise leave it out.
- Check the chapters against the rules and report the result.
- Never invent URLs, product names, discount codes or claims that are not in the transcript or the links.
- Chapter timestamps must come from the transcript, at the moment the new topic starts.
- No hashtag lists or keyword blocks; at most three hashtags, only if clearly relevant.
- Keep the description under 300 words, excluding chapters and links.
Description
The full description in one plain-text code block, ready to paste.
Chapter check
One line each: starts at 0:00, at least three, ascending, each at least 10 seconds (pass or fail with the fix).
Keywords used
The main phrase and related phrases, plus any [LINK NEEDED] items to resolve.
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
- Beginner
- 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
use in
npx @hermes-hq/hodios install write-video-chapters --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-video-chapters -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 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.
write-youtube-scriptPackage 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-thumbnailWrite podcast show notes
Writes podcast show notes from an episode transcript with a summary, timestamps, key takeaways, guest links and verbatim quotable lines. Use when publishing an episode.
write-show-notesWrite 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 tutorial video script
Scripts a screen-recorded tutorial with the outcome first, click-level steps, on-screen callouts, viewer pauses and a recap, one task per video. Use when recording a software how-to.
write-tutorial-video-scriptCreate a paper edit
Builds a paper edit from interview or footage transcripts with selects, sequence, timecodes, b-roll and graphics cues and a target runtime. Use before opening the editing software.
create-paper-edit