chengfeng-subtitle

Generate and review subtitles for edited talking-head videos from word-level transcripts and edit lists.

3.0k|383|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/Agentchengfeng/chengfeng-videocut-skills --skill chengfeng-subtitle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chengfeng-subtitle
Source: https://github.com/Agentchengfeng/chengfeng-videocut-skills/tree/main/plugins/chengfeng-videocut/skills/chengfeng-subtitle
Command: npx skills add https://github.com/Agentchengfeng/chengfeng-videocut-skills --skill chengfeng-subtitle

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

After cutting a talking-head video, creating accurate subtitles normally requires re-transcribing the edited footage and manually fixing misrecognized proper nouns and sentence breaks. This Skill computes post-edit subtitle timing directly from the existing word-level transcript and the edit ledger, corrects misheard terms with a dictionary and the author's script, splits subtitles into per-sentence screens, and supports screen-by-screen human review in Studio.

Core Features & Use Cases

  • Timing without re-transcription: Derives each word's position in the final cut by combining transcript.json timestamps with edit-list.json, producing subtitles.json with no extra ASR pass.
  • Term correction with evidence: Applies a fixed dictionary for the speaker's standard spellings and aligns against the author's script only where context matches, reporting uncertain cases instead of guessing.
  • Sentence-based screen splitting: Splits subtitles by punctuation and pause rules, merges one-word fragments, and reports stale, too-fast, or moved screens precisely.
  • Use Case: After cutting filler words from a recorded talk, ask the agent to build subtitles; it reuses the existing transcript, fixes terms like product names via the dictionary, splits screens, and opens Studio so you can review each screen before export.

Quick Start

Use the chengfeng-subtitle skill to build subtitles for my edited project, fix the proper nouns with the dictionary, and open Studio so I can review each screen.

Frequently Asked Questions about chengfeng-subtitle

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add subtitles to an edited video without re-transcribing it?

Reuse the original word-level transcript and the edit ledger: each word's source timestamp is mapped through the kept segments to compute its position in the final cut. This avoids a second ASR pass and preserves previously corrected proper nouns.

How to fix misrecognized proper nouns in video subtitles?

Apply a term dictionary for the speaker's fixed spellings first, then align against the author's script where context matches. Cases that cannot be confirmed are reported as uncertain rather than guessed, since a wrong name is worse than a transcription error.

Does this subtitle workflow require exporting the cut video first?

No. Subtitle timing is computed arithmetically from the transcript and edit list, so neither a source_cut.mp4 export nor re-transcription is needed. The output is subtitles.json, with burn-in handled later by the export step.

What happens to existing subtitles when edits change?

Rebuilding without the replace flag is refused to protect manual edits, and the user must confirm before overwriting. Stale screens are reported precisely by screen number and lost words, never as a vague expiration warning.

Why does subtitle splitting create very short screens?

Short screens come from the one-comma-one-screen rule when the speaker talks fast, and they reflect real speech rather than a defect. Only screens with too much text for their duration are flagged as tooFast and must be resolved.