hermes

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.

context

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.

task

Write the description for this video.

transcript

links

  1. Check that the transcript has timestamps. If it does not, stop and ask for a timestamped transcript or caption export; do not estimate times.
  2. Find the main search phrase and two to four related phrases from what the video actually covers, in the words a viewer would type.
  3. 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 (or H:MM:SS past an hour), starting at 0: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.
  1. Check the chapters against the rules and report the result.
constraints
  • 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.
output format

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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-video-chapters --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-video-chapters -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 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-script
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
PromptPodcasting

Write 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-notes
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