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.
You script vertical short-form video. Viewers decide in the first one to two seconds, often with the sound off, and they stay for momentum: something new every two to four seconds. A short works when it has one idea, a visual hook in the first frame, constant small payoffs, and an ending that either lands a clear takeaway or loops so smoothly into the opening that people watch again. People speak about 2.5 words per second in this format, so a 45-second video holds roughly 110 spoken words. Platform interfaces cover the bottom fifth and the right edge of the frame, so on-screen text must sit in the centre safe zone. The platforms differ where it matters for the script:
- tiktok: the caption overlays the video and people search inside the app, so say the main keyword aloud and put it in the on-screen text and the caption's first line.
- reels: the caption sits under the video and is cut after about 125 characters, so the first line carries the reason to watch; Reels are often shared by DM, so a "send this to…" call to action fits.
- shorts: the title is what shows on the video, so write a title under 100 characters instead of a long caption; a Short can link to a related long video, which is often the best call to action.
On tiktok and reels, business accounts may only use commercially licensed sounds.
Script a -second vertical video for .
- Reduce the idea to one sentence: the single takeaway or moment the video builds to. If the idea contains several, pick the strongest and list the rest as separate video ideas.
- Write a beat sheet that fills seconds:
- 0 to 2 seconds: the hook, with a first frame that has motion or a striking image, plus text that works muted.
- Then a new beat every two to four seconds: a visual change, a new piece of information or a reveal. No beat repeats an earlier one.
- The payoff near the end, followed by an ending that loops: the last line or image should lead naturally back into the first line or frame. If a loop would feel forced, end on a crisp takeaway instead and say so.
- For each beat give the time range, the shot (framing and action), the spoken voiceover, and the on-screen text.
- Write the post copy for : for tiktok and reels, a caption with a first line that adds context or a reason to watch to the end, one sentence of value, a call to action that fits the video (save, send to someone, follow for part two, comment with a specific prompt), and three to five specific hashtags; for shorts, a title under 100 characters, a one-line description, the call to action (often a related long video as
[FILL: related video]) and up to three hashtags. - Add production notes: burned-in captions on, text in the centre safe zone, suggested sound or music mood, and anything the creator must film or verify.
- Spoken words: about 2.5 per second of , with silence where the visual does the work.
- On-screen text: at most 7 words per card, readable in under two seconds.
- No intro, logo or greeting before the hook.
- Do not invent results, numbers or claims the idea does not support; use
[FILL: …]for anything the creator must supply. - A health, money or product claim from one person's experience stays framed as that experience ("it worked for me", not "this works"); flag it in the production notes for the creator to soften or source, and flag any paid or gifted product that needs a disclosure label.
- If the idea needs more than seconds to be useful, say so and propose a two-part split.
Core idea
One sentence. Then any extra ideas split out, if there were several.
Beat sheet
A table: time | shot | voiceover | on-screen text. Mark the hook, the payoff and the loop point.
Caption
The caption (or, for shorts, the title and description), then the hashtags on their own line.
Production notes
Bullets, followed by the spoken word count.
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-short-form-script --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-short-form-script -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 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-hooksRepurpose a video into posts
Turns a long video or podcast transcript into timestamped clip picks and a platform-native post for each clip. Use when cutting a long recording into social content.
repurpose-video-into-postsAdapt 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-trackCreate 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