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-notesAdapt 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