Install Captions
Pick your agent. Every command is ready to paste.
npx skills add appariciojunior/video-editor-skills --skill captionsThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads captions when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the captions skill”. In Codex, type $captions.
Captions
Goal: people watching on mute can follow; the captions are just there, never in the way.
Source
The verbatim transcript mapped onto the current timeline (follow the creator's trims), not Resolve's own auto-captions (a second, less accurate transcription). Drop words on B-roll (radio lyrics, background talk).
Clean, not verbatim
Captions show what they mean, written correctly:
- Stutters: "pro-product" → "product", "da-da," → "da,".
- Cut-off words: "es--", "A--" → gone.
- Filler sounds: drawn-out "uuum", "hããã", "ééé" → gone. Careful with real words that look like fillers ("um" = "a" in Portuguese, "é" = "is").
- Self-corrections: "get a, an appointment" → "get an appointment".
- Spoken short forms → correct written forms, if the creator asks. Brazilian Portuguese example: cê/cês → você/vocês, tá → está, tô → estou, tava → estava, tamo → estamos, vamo → vamos, pra/pro → para/para o, né → não é, "o que que" → "o que", "por que que" → "por que", "tu consegue" → "você consegue"; "tão" → "estão" only before a verb in -ndo ("tão bonito" stays). Keep expressions and swear words (fix grammar, not voice). Keep capital letters at sentence starts when you shorten.
- Names and spellings checked on the web (transcripts garble product names), and the creator's own name exactly as they write it.
- Don't reveal what the creator wants kept secret (a place, a company) even if they say it.
Keep two lists: global rules (word map + phrases) in config, per-video fixes in caption_fixes.json. Apply phrase fixes after the word map.
Lines
- One line, max 42 characters; a sentence's last word may stretch it to ~50 rather than sit alone.
- New cue at a pause ≥ 0.6 s, at sentence ends (if the line is already substantial), or after 3.2 s.
- Min 0.9 s on screen, end 0.25 s after the last word, never overlapping the next.
- A lone small word after a pause ("que", "vai", "not") joins the next line. Single-word cues are fine only when they stand alone ("Calm down.", "Bye.").
- First cue starts at 00:00:00,000 (Resolve's import shifts everything relative to the first cue).
- Write a new file name per version (
captions_v3.srt).
Read every cue
Print every line and actually read it before handing it over. Grep for leftover short forms, double punctuation (",,"), lowercase after a full stop, words lost by your own filters. Fix rules, regenerate, read again.
Into Resolve
The creator imports with File > Import > Subtitle (the API places subtitles after the timeline end; a workaround crashed Resolve). Delete the old subtitle clips but keep the track so its style stays.
Style
Record the creator's style once (font, size, position, shadow) from their timeline and save it in config as the house style, e.g. a light sans at size 68, centred ~11% up from the bottom, soft drop shadow. Overlays must stay out of that band (see motion-overlays).
Tips for Captions
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 12 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Captions
What does the Captions skill do?
Clean, readable burned-in style subtitles from the verbatim transcript - stutters and fillers removed, spoken slang written correctly, one short line at a time, names checked, every line read by Claude before import into DaVinci Resolve. Use for "subtitles", "captions", "legendas", or when the creator reports wrong words in the captions.
How do I install Captions?
Run "npx skills add appariciojunior/video-editor-skills --skill captions" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Captions work in Cursor and Codex?
Yes. Captions uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Captions free?
Captions is open source on GitHub. It is free to install; check the license before commercial use.
Who made Captions?
Captions is published by appariciojunior in the appariciojunior/video-editor-skills repository, together with 11 other skills.
