viral-video-animated-captions — Claude Code skill
viral-video-animated-captions turns a word-level transcript into ASS captions with pop, bounce and karaoke highlighting, then burns them into the video with FFmpeg.
MIT 196 installs ★ 66 updated 2026-06-18
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-animated-captions -a claude-codeWhat viral-video-animated-captions does
The skill walks through five stages: a transcript with word timestamps from Whisper or another ASR tool, conversion of those timings into ASS events and styles, a burn-in pass with FFmpeg, then a check on readability and sync. Word timings are the raw material. Without them there is nothing to animate.
Styles come as a short table: Word Pop, Highlight Sweep, Karaoke Fill, Typewriter, Bounce In, each with a note on where it fits. The heavy material sits in references/caption-styles-and-generation.md — generation scripts, easing and spring formulas, color schemes, font picks, guidance per platform for TikTok, YouTube Shorts and Instagram Reels. The skill file itself stays a thin orchestrator. One detail that trips people up: ASS karaoke tags count in centiseconds while animation tags count in milliseconds.
Burn-in is a single ffmpeg -vf "ass=captions.ass" call. Audio copy fails when the output container will not take the source track, so those files need -c:a aac -b:a 128k instead. On readability the skill asks for 3-6 words on screen, a large sans-serif face with a thick outline, and captions kept clear of the lower strip where mobile UI sits.
What it helps with
- Turn a Whisper transcript into word-by-word captions
- Pick an animation preset that suits a vertical short
- Burn ASS subtitles into MP4 without losing sync
- Fix timing when the highlight drifts off the voice
- Keep captions inside mobile safe zones
Example prompts for the agent
- Generate Word Pop captions from
transcript.jsonand burn them intoclip.mp4 - Restyle the karaoke pass for Reels with 3-6 words per screen
- Check
captions.assfor safe-zone placement and audio sync
How to install viral-video-animated-captions
1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-animated-captions -a claude-code2Manually: put the files in place
~/.claude/skills/viral-video-animated-captions/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/viral-video-animated-captions/
1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-animated-captions -a codex2Manually: put the files in place
.agents/skills/viral-video-animated-captions/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-animated-captions -a cursor2Manually: put the files in place
.cursor/skills/viral-video-animated-captions/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install JosiahSiegel/claude-plugin-marketplace plugins/ffmpeg-social-video/skills/viral-video-animated-captions2Manually: put the files in place
.github/skills/viral-video-animated-captions/SKILL.md1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-animated-captions -a gemini-cli2Platform CLI
gemini skills install https://github.com/JosiahSiegel/claude-plugin-marketplace --path plugins/ffmpeg-social-video/skills/viral-video-animated-captionsManually: put the files in place
.devin/skills/viral-video-animated-captions/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-animated-captions -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about viral-video-animated-captions
How do I install viral-video-animated-captions in Claude Code?
Run npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-animated-captions -a claude-code. The skill lands at ~/.claude/skills/viral-video-animated-captions/SKILL.md.
What does viral-video-animated-captions do?
It converts a word-timestamped transcript into ASS captions with CapCut-style animation and burns them into the video through FFmpeg. Style presets, color schemes and readability rules for vertical video are included.
Which timing unit goes where in ASS?
Karaoke tags take centiseconds, animation tags take milliseconds. Mix the two and the highlight falls out of step with the audio.
Source text
SKILL.md · MIT
--- name: viral-video-animated-captions description: | CapCut-style animated word-level captions for viral video with FFmpeg. PROACTIVELY activate for: (1) Word-by-word caption highlighting, (2) Animated subtitle effects, (3) CapCut-style captions, (4) Karaoke-style text, (5) Bounce/pop text animations, (6) Color-changing words, (7) Emoji integration in captions, (8) Multi-style caption presets, (9) Trending caption styles, (10) Social media caption optimization. Provides: ASS subtitle generation scripts, word-level timing workflows, animation presets, color schemes, font recommendations, and platform-specific caption styles for TikTok, YouTube Shorts, and Instagram Reels. --- # CapCut-Style Animated Captions Use this skill to create burned-in social captions with word-level timing, pop/bounce/scale animations, karaoke highlighting, and platform-appropriate caption styles. This SKILL is a lean orchestrator; detailed ASS styles, scripts, formulas, and presets are preserved in `references/caption-styles-and-generation.md`. ## When to Use - Word-by-word or phrase-by-phrase social captions - CapCut-style pop, bounce, sweep, karaoke, and typewriter captions - Whisper transcript to animated ASS conversion - TikTok, YouTube Shorts, Instagram Reels, and Facebook Reels caption styling - Caption readability, safe zones, accessibility, and mobile typography ## Caption Workflow 1. Generate transcript with word-level timestamps using Whisper or another ASR tool. 2. Convert word timings into ASS events and styles. 3. Use ASS timing units correctly: karaoke tags use centiseconds; animation tags use milliseconds. 4. Burn ASS into the video with FFmpeg. 5. Verify readability, safe-zone placement, audio sync, and final platform specs. ## Minimal Burn-In Command ```bash ffmpeg -i input.mp4 \ -vf "ass=captions.ass" \ -c:v libx264 -preset fast -crf 23 \ -c:a copy \ output_captioned.mp4 ``` If audio copy fails because the output container cannot accept the source audio, re-encode audio with `-c:a aac -b:a 128k`. ## Quick Style Selection | Style | Effect | Best for | |---|---|---| | Word Pop | Each word scales in with overshoot | High-energy hooks, gaming, comedy | | Highlight Sweep | Full phrase visible, words highlight in sequence | Educational and professional explainers | | Karaoke Fill | Progressive fill across words | Music, voiceover, lyric-style captions | | Typewriter | Characters appear progressively | Dramatic storytelling | | Bounce In | Words move/scale from below | Shorts/Reels emphasis beats | ## Timing and Readability Rules - Word-level animations usually need 80-250ms appear time and 200-600ms dwell, depending on platform. - Keep 3-6 words on screen for vertical social video. - Use large sans-serif fonts, high contrast, and a thick outline. - Avoid excessive shake/flash; keep accessibility and readability ahead of novelty. - Keep captions inside mobile safe zones; avoid the lower UI-heavy region. ## Reference Map - `references/caption-styles-and-generation.md` - Full preserved reference: Whisper timestamp commands, ASS structure, WordPop/Sweep/Karaoke/Typewriter/Bounce examples, Python JSON-to-ASS script, bash pipeline, burn commands, style presets, color schemes, emoji integration, platform guidelines, troubleshooting, spring/easing/shake/pulse formulas, accessibility guidance, sources. ## Related Skills - `ffmpeg-captions-subtitles` - Subtitle fundamentals and burn-in - `ffmpeg-karaoke-animated-text` - ASS karaoke and animated text patterns - `ffmpeg-animation-timing-reference` - Timing units, easing, readability, sync - `viral-video-platform-specs` - Export specs and safe zones - `viral-video-hook-templates` - Hook and retention strategy
© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace