Agent skill

Karaoke Captions

by AI-Builder-Club in AI-Builder-Club/skills

Generate TikTok/Shorts-style karaoke captions using MLX Whisper, ASS subtitles, and FFmpeg libass.

No licenceAuto-check passedMedia & Creative

Install Karaoke Captions

skills CLI
$ npx skills add AI-Builder-Club/skills --skill karaoke-captions -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AI-Builder-Club/skills karaoke-captions --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AI-Builder-Club/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/karaoke-captions .claude/skills/karaoke-captions && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
karaoke-captions
GitHub stars
1.3k
Token cost
~850 tokens
SKILL.md length
202 words
Files
11 (incl. scripts, references)
Skills in repo
11
Repo updated
First seen
Licence
None found

At a glance

Generate TikTok/Shorts-style karaoke captions using MLX Whisper, ASS subtitles, and FFmpeg libass.

  • Works in 5 steps: Extract Word Timestamps → Select Style or Auto-match from… → Generate ASS Subtitles → …
  • Burning word-level highlight captions into a video
  • SKILL.md covers Requirements, File Architecture, Standard Workflow and References & Presets
  • Runs Python and Shell scripts from its folder; calls python, pip and brew

What it does

Karaoke Captions is an agent skill from AI-Builder-Club/skills. 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.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts and reference files (for example `README.md`, `presets/style.json` and `presets/yellow.json`).

It sits in Media & Creative, covering Transcription, Video production and Speech recognition and synthesis. It works with FFmpeg and TikTok. The repository describes itself as: Codebase harness + loop engineer.

When your agent uses it

  • Burning word-level highlight captions into a video
  • Matching caption style from a screenshot
  • Rendering ASS karaoke subtitles
  • The user runs /karaoke-captions

Example prompts

  • “/karaoke-captions”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Extract Word Timestamps
  2. Select Style or Auto-match from Reference Image
  3. Generate ASS Subtitles
  4. Render Preview & Visual Check
  5. Render Final Video

What it can do on your machine

Read from SKILL.md and the folder at commit 917780c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 4 files in scripts/ (Python and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • ffmpeg.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Karaoke Captions loads about 850 tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 73 tokens; SKILL.md has 202 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~850
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 202 words (~850 tokens).

“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.”

— opening of SKILL.md by AI-Builder-Club
name
karaoke-captions
user_invocable
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 10 other files (scripts, references) in skills/karaoke-captions of AI-Builder-Club/skills.

  • SKILL.md
  • .gitignore
  • README.md
  • presets/style.json
  • presets/yellow.json
  • references/style-guide.md
  • requirements.txt
  • scripts/extract_words.py
  • scripts/gen_ass.py
  • scripts/match_style_from_image.py
  • scripts/render.sh

Open the folder on GitHubat commit 917780c

Compare with similar skills

Karaoke Captions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Karaoke Captions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Karaoke Captions this skillAI-Builder-Club/skills1.3k—~850Automated safety check: PassNone
AutoshortsUpload-Post/skill-autoshorts151—~5.3kAutomated safety check: NotesMIT
Watchmathiaschu/watch142—~4kAutomated safety check: WarnMIT
Bggg Tiktok Readvideobinggandata/bggg-skills605—~1.6kAutomated safety check: PassMIT
Bggg Tiktok Cutbinggandata/bggg-skills605—~954Automated safety check: PassMIT
Caption Burngooseworks-ai/goose-skills1.2k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Autoshorts

    Upload-Post/skill-autoshorts

    Daily pipeline that picks one long video from a folder, transcribes it with Whisper, uses Gemini 3 Flash multimodal to find every viral short-form moment, cuts each candidate with FFmpeg, adds a…

    151 GitHub stars~5.3k tokensUpdated 5 mo ago
    Media & CreativeAuto-check: notes
  • Watch

    mathiaschu/watch

    Watch a video from YouTube, Instagram, X/Twitter, Vimeo, TikTok or any of ~1800 yt-dlp sites (or a local path).

    142 GitHub stars~4k tokensUpdated 4 mo ago
    Media & CreativeAuto-check: warnings
  • Bggg Tiktok Readvideo

    binggandata/bggg-skills

    把 TikTok、Reels、YouTube Shorts、UGC 广告、本地 MP4/MOV/WebM 等视频拆成 Codex 可读的视频上下文。

    605 GitHub stars~1.6k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Bggg Tiktok Cut

    binggandata/bggg-skills

    用于把 AI 生成的视频、本地素材、口播素材或产品短片剪成可发布到 TikTok 的竖屏成片. An agent skill from binggandata/bggg-skills.

    605 GitHub stars~954 tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Caption Burn

    gooseworks-ai/goose-skills

    Burned-in captions for a finished vertical video, three kinds.

    1.2k GitHub stars~1.2k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Ffmpeg Skill

    kajisho5/ffmpeg-skill

    Edit video and audio with local FFmpeg from natural-language requests: cut, trim, join, resize/reframe (9:16, 1:1), speed change, captions and subtitles (SRT/ASS, animated, karaoke), logos and text…

    1.9k GitHub stars~7.4k tokensUpdated yesterday
    Media & CreativeAuto-check passed

More from AI-Builder-Club/skills

All 11 skills in this repo
  • Visual Flow Gif

    AI-Builder-Club/skills

    Create animated flow diagrams from articles, workflow notes, architecture sketches, or process descriptions using a JSON specification and a local Python/Pillow renderer.

    1.3k GitHub stars~845 tokensUpdated 25 days ago
    Auto-check passed
  • Open Agent Teams

    AI-Builder-Club/skills

    Delegate tasks to ANY CLI agent (claude, codex, aider, ...) running in a detached tmux session, with a race-safe done-signal protocol and multi-turn iteration.

    1.3k GitHub stars~1.4k tokensUpdated 25 days ago
    Auto-check passed
  • New Loop

    AI-Builder-Club/skills

    Spin up a new loop (domain) in a file-based knowledge base — bootstrap the substrate if it's missing, gather the loop's charter, scaffold domains/<loop/README.md, then do ONE real test run and…

    1.3k GitHub stars~1.2k tokensUpdated 25 days ago
    Auto-check: notes
  • Crabbox Setup

    AI-Builder-Club/skills

    Scaffold an isolated CLOUD dev box per agent (via crabbox + Daytona) for any codebase — the parallel-safe counterpart to dev-local-setup.

    1.3k GitHub stars~1.9k tokensUpdated 25 days ago
    Auto-check: notes
  • SEO Growth

    AI-Builder-Club/skills

    A skill your agent uses when deciding WHERE to point SEO effort, not how to write a page.

    1.3k GitHub stars~1.9k tokensUpdated 25 days ago
    Auto-check passed
  • Dev Local Setup

    AI-Builder-Club/skills

    Scaffold a one-command dev-local launcher for ANY codebase. An agent skill from AI-Builder-Club/skills.

    1.3k GitHub stars~1.3k tokensUpdated 25 days ago
    Auto-check: notes

Works with

Questions about Karaoke Captions

What does Karaoke Captions do?

Generate TikTok/Shorts-style karaoke captions using MLX Whisper, ASS subtitles, and FFmpeg libass. Karaoke Captions is an agent skill from AI-Builder-Club/skills. Generate TikTok/Shorts-style karaoke captions using MLX Whisper, ASS subtitles, and FFmpeg libass.

When should I use Karaoke Captions?

Karaoke Captions fits situations like: burning word-level highlight captions into a video; matching caption style from a screenshot; rendering ASS karaoke subtitles; the user runs /karaoke-captions.

How do I install Karaoke Captions in Claude Code?

Run `npx skills add AI-Builder-Club/skills --skill karaoke-captions -a claude-code`. Or copy the skill folder (skills/karaoke-captions in AI-Builder-Club/skills) into .claude/skills/karaoke-captions in your project. Claude Code loads it when a task matches its description.

How do I install Karaoke Captions in Codex?

Run `npx skills add AI-Builder-Club/skills --skill karaoke-captions -a codex`. Or copy the skill folder (skills/karaoke-captions in AI-Builder-Club/skills) into .agents/skills/karaoke-captions in your project. Codex loads it when a task matches its description.

Can I use Karaoke Captions in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AI-Builder-Club/skills --skill karaoke-captions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/karaoke-captions, .gemini/skills/karaoke-captions, .github/skills/karaoke-captions and .opencode/skills/karaoke-captions in your project.

What does Karaoke Captions need to run?

Going by SKILL.md and its folder, Karaoke Captions needs Python and a shell for the scripts in its folder and the command-line tools its instructions call (python, pip and brew). Our summary lists: Python 3; A Bash shell.

Does Karaoke Captions access the network?

SKILL.md names 1 domain. As links in the text: ffmpeg.org. This is read from the text; nothing was executed.

Is Karaoke Captions safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Karaoke Captions use?

No licence was found for Karaoke Captions or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Karaoke Captions use?

About 850 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 691 tokens, read only when the agent opens those files.

What are the alternatives to Karaoke Captions?

Skills that share tags, products or a category with Karaoke Captions: Autoshorts (Upload-Post/skill-autoshorts, 151 stars), Watch (mathiaschu/watch, 142 stars), Bggg Tiktok Readvideo (binggandata/bggg-skills, 605 stars) and Bggg Tiktok Cut (binggandata/bggg-skills, 605 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Karaoke Captions?

AI-Builder-Club (a GitHub organization) maintains it in AI-Builder-Club/skills, which has 1,288 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 15, 2026.

Source: AI-Builder-Club/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.