网有NETHAVE
AGENT SKILL

caption-burn

Use when burning styled captions, subtitles, or karaoke into video with ffmpeg/libass, or soft-muxing a selectable subtitle track.

License 许可
MIT
最近更新
2026-11-02
Stars
★ 0
Forks
0

01 前言 Front Matter

name
caption-burn
description
Use when burning styled captions, subtitles, or karaoke into video with ffmpeg/libass, or soft-muxing a selectable subtitle track.

02 资源文件 1

03 SKILL.md 正文

Caption Burn (hardsub) & Soft-mux — libass / ffmpeg

Render an existing cue list onto a video, either burned in (hardcoded pixels, permanent, re-encode) or soft-muxed (a selectable, removable subtitle stream, stream-copy). This is the libass/ASS path; the styled/karaoke output path is libass burn (mov_text cannot carry the styling).

Source modules read (cite these, do not invent commands):

  • media_studio/features/caption.py — CaptionEngine, build_ass, escaping, build_burn_argv/build_softmux_argv, hook title/card, karaoke routing.
  • media_studio/features/caption_karaoke.py — OpusClip word-by-word karaoke ASS preset.
  • media_studio/features/caption_override.py — CaptionOverride -> ResolvedCaptionStyle, the ASS colour byte-swap.
  • media_studio/features/caption_polish.py — Netflix CPS/CPL/min-gap + punct/casing/emphasis/profanity polish.
  • media_studio/features/tracks.py — tracks.burn / soft_mux / strip RPC + the simpler V1 ASS builder.
  • media_studio/ffmpeg.py — the shared run() (argv-only, stderr-drain) and ffmpeg_path().

When to use / when NOT

  • USE for: painting transcript cues into a clip (standard captions, styled captions, OpusClip karaoke), adding a hook-title/hook-card headline, or muxing a removable subtitle track.
  • DO NOT use for: removing a logo/watermark (video-watermark-removal); generating the cues themselves (this skill consumes {index,start,end,text} cues already produced upstream); moving a caption that is already burned in (pixels are baked — change the position/style and re-burn from the original source); soft-muxing styled ASS into an MP4 and expecting the styling to survive (MP4 only carries mov_text, which drops ASS overrides — burn instead).

Burn vs soft-mux — the tradeoff (decide first)

Recipe (the real flow, from CaptionEngine.render)

Exact ffmpeg argv — BURN (caption.build_burn_argv)

Exact ffmpeg argv — SOFT-MUX (caption.build_softmux_argv)

STRIP a soft sub (tracks.build_strip_argv)

ASS document structure (build_ass)

libass styling fields you actually touch (CaptionOverride -> ResolvedCaptionStyle)

ASS colour format — the silent-wrong-colour trap (hex_to_ass_color)

Karaoke preset (caption_karaoke.build_karaoke_ass, style id opusclip-karaoke)

Caption polish (caption_polish.polish_cues) — run BEFORE building the ASS

Pitfalls that actually bite

GPU / model notes

04 同仓库更多 Skills

Prekzursil
Prekzursil/agent-skills-toolchain

clarify-requirements

Resolve genuine pre-execution ambiguity by scanning repo context, generating 1-6 grounded options, and asking 1-3 focused questions via AskUserQuestion. NOT for mid-task use (injection risk); NOT when the goal is already unambiguous; use to disambiguate vague prompts before any file edits.

★ 0
Prekzursil
Prekzursil/agent-skills-toolchain

openmm-md

Run FREE, open-source, Windows-native GPU molecular dynamics via the openmm-md MCP (OpenMM + CUDA on the local NVIDIA GPU). Use for protein / protein-ligand MD when you want a free stack or are on Windows without a Schrodinger license. Covers the full workflow (prepare, solvate, minimize, equilibrate, production, analyze, mmgbsa) AND an honest decision guide vs Schrodinger Desmond, including how to run Desmond legitimately on Linux or a cloud GPU with a real license. This is a deliberately LESSER free alternative and does NOT replace the schrodinger MCP tools. Do NOT use it to pick a free tool when a validated FEP+, WaterMap, IFD-MD, or Prime MM-GBSA result is actually required.

Skill与智能体开发
★ 0
Prekzursil
Prekzursil/agent-skills-toolchain

visual-review

Take screenshots of web pages and UI using Playwright for visual review and iteration

演示文稿测试与质量
★ 0
Prekzursil
Prekzursil/agent-skills-toolchain

status

Diagnostic status report — shows metaswarm installation state, project setup, and potential issues

★ 0
Prekzursil
Prekzursil/agent-skills-toolchain

start

Use when starting work on any task, when the user mentions metaswarm, or when the user wants to begin tracked development work

Skill与智能体开发
★ 0
Prekzursil
Prekzursil/agent-skills-toolchain

setup

Interactive project setup — detects your project, configures metaswarm, writes project-local files

★ 0