Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-animated-captions -a claude-code
Open on GitHub

What 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.json and burn them into clip.mp4
  • Restyle the karaoke pass for Reels with 3-6 words per screen
  • Check captions.ass for 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-code

2Manually: put the files in place

~/.claude/skills/viral-video-animated-captions/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/viral-video-animated-captions/

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

Similar skills

All skills for Marketing and content →

From the same set96

The whole set →
powershell-shell-detection powershell-shell-detection is a Claude Code skill that identifies whether a script runs in PowerShell, Git Bash/MSYS2, or cmd. It helps with Windows paths and command invocation across shells. CX Codex +1 211installs tailwindcss-debugging tailwindcss-debugging diagnoses missing styles, fixes dynamic class name issues, and guides builds through Tailwind CSS v4 upgrades. CX Codex +1 209installs tailwindcss-plugins tailwindcss-plugins — a Tailwind CSS plugin reference the agent loads on its own: official typography, forms and container queries, custom plugin() utilities, and the v3 to v4 move. CX Codex +1 204installs windows-path-troubleshooting windows-path-troubleshooting — a skill that tells the agent how to write Windows paths for Read, Write and Edit, and how to convert Git Bash paths that end in ENOENT. CX Codex +1 199installs ffmpeg-audio-processing ffmpeg-audio-processing — a skill that turns ffmpeg into a guided audio pipeline: codec choice, EBU R128 loudness, pulling tracks out of video. Handy for podcasts and broadcast masters. CX Codex +1 195installs powershell-security powershell-security implements modern PowerShell hardening: stores credentials with SecretManagement, creates JEA role endpoints, and configures WDAC policies. CX Codex +1 194installs query-optimization query-optimization — an agent skill for slow T-SQL on SQL Server and Azure SQL: check schema and plan evidence first, then rewrite, re-index or hint. CX Codex +1 194installs ffmpeg-kinetic-captions ffmpeg-kinetic-captions writes ASS subtitles with animated captions: a karaoke highlight that scales each word, pop-in bounces, shake on the beat. Made for vertical video. CX Codex +1 193installs

Project sponsors

Companies that keep this analytics open