Countdown List
Top-N countdown: a big rank number stamps in for each item with its name in a banner beside it.
- Best for: top 5 / top 10 lists, rankings, tools, tips, product round-ups
- Category: Talking-head reel
- Default format: 9:16 (change with
--format 9:16 | 1:1 | 4:5 | 16:9) - Needs camera footage: yes, a raw talking clip
- Text behind the speaker: no
Before you start
This style runs on the video-studio-core skill, which must be installed in the same skills folder.
CORE= thevideo-studio-corefolder next to this one (e.g.~/.claude/skills/video-studio-core).STYLE= this skill's folder (it holdstheme.jsonandtheme.css).- First time on a machine:
python CORE/scripts/check_env.py, and fix anything it reports. - If
COREis missing, tell the user to installvideo-studio-corefrom the same pack.
Make the edit
python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-countdown-list --stop-after plan
# refine edit-*/plan.json (see below), then check stills:
python CORE/scripts/render.py edit-countdown-list/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-countdown-list/plan.json
python CORE/scripts/finish.py edit-countdown-list/plan.json
Open contact_sheet.png and look at it before the full render. The final video is final.mp4 in the work folder.
Use --formats 1:1,16:9 on finish.py for extra sizes. Add music with "music": {"src": "track.mp3", "volume": 0.12} in the plan.
The look
- Each item: big '#N' slams in at top-left with the item name in a banner beside it; it holds until the next item.
- Speaker full frame, captions centre-low, boom on each number.
Refine the plan
The draft from make_plan.py is automatic. Make it good:
- Read
words.jsonand rewrite the hook (first 2-3 s) into a short, specific promise. - Replace weak auto-picked key words with the words that carry the meaning (numbers, results, names, contrasts).
- Fix any mis-heard words in the
wordsarray (keep their times). - make_plan detects 'first / number one / step two' sentences. If the speaker doesn't use them, add the items yourself: for each item one
text(classcd-num, text '#5') and onetext(classcd-name) at the moment the item starts. - Rank order: count down (5 to 1) unless the user says otherwise; change
countdownin theme.jsonauto.lists. - Element types and fields:
CORE/references/plan-schema.md.
Check before delivering
- Contact sheet: text readable, nothing cut off, nothing covering the face unless intended, safe zones respected (9:16: keep text between 10% and 85% of the height).
- Watch for timing: overlays land with the spoken word, not after it.
ffprobethe final file: right size, duration and audio.- Tell the user what you cut (seconds removed), what the look adds, and where the file is.
Change the look
Colours and fonts live in theme.json (vars, fontsUrl) and theme.css. For a one-off change, edit plan.json (theme.vars, element style) instead of the skill files.
Example requests
- "Countdown list edit for my top 5 tools."
- "Make my ranking video with big numbers."
- "Top 10 tips format."