AI-Builder-Club
Install Karaoke Captions
Pick your agent. Every command is ready to paste.
npx skills add AI-Builder-Club/skills --skill karaoke-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 karaoke-captions when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the karaoke-captions skill”. In Codex, type $karaoke-captions.
Karaoke Captions Skill
Generate dynamic, TikTok/Shorts-style karaoke captions with word-level highlight sweeps using ASS subtitles and FFmpeg libass. Supports style matching from a reference screenshot.
Scripts, presets, and references live next to this skill. Run the commands from the skill directory (or pass absolute paths).
Requirements
- macOS with Apple Silicon (MLX Whisper)
- Python 3.10+
- FFmpeg with
libass(brew install ffmpeg)
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
reference.png --------(match_style_from_image.py)--------> style.json --+
+--(gen_ass.py)--> captions.ass --(render.sh)--> output.mp4
input.mp4 ---------------------------------->(extract_words.py)--> words.json --+
File Architecture
| File | Purpose | Role |
|---|---|---|
input.mp4 |
Source video | Input |
reference.png |
Style reference image (optional) | Visual Prompt |
words.json |
Word-level timestamps [{"word": ..., "start": ..., "end": ...}] |
Persistent Raw Data |
style.json |
Font, size, highlight color, outline, soft shadow, margin, words per line | Style Config |
captions.ass |
ASS subtitle script with two-layer blurred drop shadow and inline color overrides | Generated Intermediate |
output.mp4 |
Final video with burned-in subtitles | Output Deliverable |
Standard Workflow
Step 1. Extract Word Timestamps
python scripts/extract_words.py \
input.mp4 words.json \
--model mlx-community/whisper-large-v3-turbo
(For Chinese videos, add --language zh).
Step 2. Select Style or Auto-match from Reference Image
- From Reference Image:
python scripts/match_style_from_image.py \ reference.png style.json --video input.mp4 - From Presets:
presets/style.json: Default neon green highlight (#00FF00), Arial Black, all-caps, 4 words/line.presets/yellow.json: Yellow highlight (#FFFF00), Arial Black, all-caps.
To adjust appearance manually, see Style Guide.
Step 3. Generate ASS Subtitles
python scripts/gen_ass.py \
words.json style.json captions.ass --video input.mp4
Step 4. Render Preview & Visual Check
# Preview segment:
scripts/render.sh input.mp4 captions.ass preview.mp4 3 8
# Frame snapshot:
scripts/render.sh frame input.mp4 captions.ass preview_frame.png 4.5
Step 5. Render Final Video
scripts/render.sh input.mp4 captions.ass output.mp4
References & Presets
Tips for Karaoke Captions
- • Start a fresh session after installing so your agent picks up the new skill.
- • This skill ships scripts. Read them before the first run, and run it in a project without secrets first.
- • It bundles reference files. The agent reads them only when needed, so they cost no context until then.
- • It is part of a pack with 11 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 Karaoke Captions
What does the Karaoke Captions skill do?
Generate TikTok/Shorts-style karaoke captions using MLX Whisper, ASS subtitles, and FFmpeg libass. Use when burning word-level highlight captions into a video, matching caption style from a screenshot, rendering ASS karaoke subtitles, or when the user runs /karaoke-captions.
How do I install Karaoke Captions?
Run "npx skills add AI-Builder-Club/skills --skill karaoke-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 Karaoke Captions work in Cursor and Codex?
Yes. Karaoke 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 Karaoke Captions free?
Karaoke Captions is open source on GitHub. It is free to install; check the license before commercial use.
Who made Karaoke Captions?
Karaoke Captions is published by AI-Builder-Club in the AI-Builder-Club/skills repository, together with 10 other skills.
