Skip to content
cccskills
FreePublished on GitHub

karaoke-captions

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.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror
Works withTikTok

Run score Not tested

See how to install

Files included (11)

  • SKILL.md3.3 KB
  • .gitignore269 B
  • presets/style.json369 B
  • presets/yellow.json369 B
  • README.md1.7 KB
  • references/style-guide.md2.7 KB
  • requirements.txt25 B
  • scripts/extract_words.py2.0 KB
  • scripts/gen_ass.py7.3 KB
  • scripts/match_style_from_image.py4.2 KB
  • scripts/render.sh1.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

FilePurposeRole
input.mp4Source videoInput
reference.pngStyle reference image (optional)Visual Prompt
words.jsonWord-level timestamps [{"word": ..., "start": ..., "end": ...}]Persistent Raw Data
style.jsonFont, size, highlight color, outline, soft shadow, margin, words per lineStyle Config
captions.assASS subtitle script with two-layer blurred drop shadow and inline color overridesGenerated Intermediate
output.mp4Final video with burned-in subtitlesOutput 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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

<provider-id>

Free

<What it does, one line>. Trigger phrases: <phrases>.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 24, 2026

academic-pptx

Free

Use this skill whenever the user wants to create or improve a presentation for an academic context — conference papers, seminar talks, thesis defenses, grant briefings, lab meetings, invited lectures, or any presentation where the audience will evaluate reasoning and evidence. Triggers include: 'conference talk', 'seminar slides', 'thesis defense', 'research presentation', 'academic deck', 'academic presentation'. Also triggers when the user asks to 'make slides' in combination with academic content (e.g., 'make slides for my paper on X', 'create a presentation for my dissertation defense', 'build a deck for my grant proposal'). This skill governs CONTENT and STRUCTURE decisions. For the technical work of creating or editing the .pptx file itself, also read the pptx SKILL.md.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 24, 2026

adapt

Free

Shortest English alias for web-adapt / universal-web-adaptation. Use this when adapting an unfamiliar public website generically before creating any site-specific rules.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 24, 2026

adapter-audit

Free

Use this skill to audit CLI adapter projects (like opencli) for missing output fields, then batch-generate fixes and submit PRs. Turns AI agents into adapter quality reviewers.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 24, 2026

ads

Free

Operate professional paid advertising across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, and X. Use for account intake, source-grounded audits, strategy, budget and measurement planning, creative production, experiments, reporting, monitoring, and explicitly approved campaign changes. Also trigger on PPC, paid social, retail media, attribution, tracking, landing pages, cross-platform conversion totals, negative keywords or search terms, beta-feature scoring, stale platform claims, API-token or credential setup, campaign deletion, and safe Claude Ads installation or uninstall.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 24, 2026

ads-amazon

Free

Audit Amazon Ads profiles, regions, Sponsored Products, Sponsored Brands, Sponsored Display, DSP, portfolios, targeting, search terms, retail readiness, creative, budgets, ACOS, TACOS, reporting, and policy. Use for Amazon Ads, sponsored ads, Amazon PPC, ACOS, TACOS, ASIN advertising, Amazon DSP, or retail-media optimization.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 24, 2026

See all skills by gabrielmoreira

Report a problem with this skill