Agent skill

Subtitle Correction

by sugarforever in sugarforever/01coder-agent-skills

Fixes speech-recognition mistakes in .srt subtitle files, in Chinese or English, using terms you supply and leaving every timestamp untouched.

MITAuto-check passedMedia & Creative

Install Subtitle Correction

skills CLI
$ npx skills add sugarforever/01coder-agent-skills --skill subtitle-correction -a claude-code

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

GitHub CLI
$ gh skill install sugarforever/01coder-agent-skills subtitle-correction --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/sugarforever/01coder-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/subtitle-correction .claude/skills/subtitle-correction && 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
subtitle-correction
GitHub stars
136
Token cost
~2.3k tokens
SKILL.md length
753 words
Files
4 (incl. scripts, references)
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Fixes speech-recognition mistakes in .srt subtitle files, in Chinese or English, using terms you supply and leaving every timestamp untouched.

  • Works in 3 steps: Request Terminology from User → Confirm Understanding → Process with Terms
  • Proofreading .srt subtitles produced by automatic speech recognition
  • SKILL.md covers Interactive Workflow, Core Workflow, Strict Rules and User-Provided Terminology, plus 5 more sections
  • Runs Python scripts from its folder; calls python

What it does

Before any editing the agent asks for domain terms such as proper nouns, brands and technical vocabulary, then repeats the list back and names the likely domain, for example an AI course or web development. If you have no terms, it uses built-in patterns, flags the corrections it is unsure about and asks afterward whether it missed any. It works on programming tutorials and other content with specialist terminology.

The rules are strict: never change timestamps or subtitle numbering, and never merge or split entries, so the output stays one to one with the input. Error types include Chinese homophone mistakes, such as pairs of characters that sound alike, and misrecognized framework or programming terms. Bundled files are references on the SRT format and terminology plus scripts/subtitle_tool.py. The excerpt is truncated.

When your agent uses it

  • Proofreading .srt subtitles produced by automatic speech recognition
  • Fixing technical terms in programming or AI course captions
  • Correcting Chinese homophone errors without touching the timeline

Example prompts

  • “Fix the speech recognition errors in lecture.srt; the course covers LangChain and LangGraph.”
  • “Proofread this Chinese subtitle file and flag the corrections you are unsure about.”
  • “Correct tutorial.srt and keep every timestamp exactly as it is.”

Requirements

  • Python to run the bundled subtitle_tool.py script

Workflow steps

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

  1. Request Terminology from User
  2. Confirm Understanding
  3. Process with Terms

What it can do on your machine

Read from SKILL.md and the folder at commit e51fb6e. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

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

  • Network

    No URLs in SKILL.md.

    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

Subtitle Correction loads about 2.3k tokens when it runs, and up to ~3.8k if it reads all its reference files. Until then it costs about 108 tokens; SKILL.md has 753 words of instructions outside code blocks.

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

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

The full file from sugarforever/01coder-agent-skills at commit e51fb6e, republished under its MIT licence (© sugarforever). 753 words, ~2,293 tokens.

Download SKILL.mdSave it as .claude/skills/subtitle-correction/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
subtitle-correction
description
Correct subtitle files (.srt) generated from speech recognition. Use when the user uploads subtitle files and asks to correct, fix, or proofread subtitles, especially for technical content like programming tutorials, AI/ML courses, or any content with domain-specific terminology. Supports Chinese and English subtitles with intelligent error detection and correction while preserving exact timeline information.

Subtitle Correction Skill

This skill corrects speech recognition errors in subtitle files while strictly preserving timeline information.

Interactive Workflow

Step 1: Request Terminology from User

IMPORTANT: Before starting any correction, ALWAYS ask the user for domain-specific terms.

Prompt the user with:

在开始修正之前,请提供一些关键术语,帮助我更准确地识别和修正语音识别错误:

1. **专有名词**:人名、品牌名、产品名等(如:Anthropic、Claude)
2. **技术术语**:框架、库、工具名称(如:LangChain、OpenAI、PyTorch)
3. **领域词汇**:行业特定词汇(如:checkpointer、middleware、runtime)
4. **其他关键词**:视频中频繁出现的重要词汇

请用逗号分隔,例如:`LangChain, Agent, OpenAI, checkpointer`

For English users:

Before I begin correction, please provide key terms to help me accurately identify speech recognition errors:

1. **Proper nouns**: Names, brands, products (e.g., Anthropic, Claude)
2. **Technical terms**: Frameworks, libraries, tools (e.g., LangChain, PyTorch)
3. **Domain vocabulary**: Industry-specific terms (e.g., checkpointer, middleware)
4. **Other keywords**: Important words that appear frequently

Please separate with commas, e.g.: `LangChain, Agent, OpenAI, checkpointer`
Step 2: Confirm Understanding

After receiving terms, confirm by:

  1. Listing the terms received
  2. Identifying the likely domain/context (AI/ML tutorial, web dev, etc.)
  3. Asking if there are any additional terms before proceeding

Example response:

收到以下术语:
- 技术框架:LangChain, LangGraph, OpenAI
- 技术概念:Agent, checkpointer, runtime

看起来这是一个 LangChain 智能体开发的教程视频。

还有其他需要补充的术语吗?如果没有,我将开始修正字幕。
Step 3: Process with Terms

Use the provided terms to:

  1. Build a mental model of expected vocabulary
  2. Identify likely speech recognition errors
  3. Apply consistent corrections throughout
When User Doesn't Provide Terms

If user says "没有" / "no" / "直接开始":

  1. Proceed with correction using built-in patterns
  2. Flag uncertain corrections for user review
  3. After completion, ask if any terms were missed

Core Workflow

  1. Read the subtitle file - Load the .srt file provided by the user
  2. Identify error patterns - Recognize common speech recognition mistakes
  3. Apply corrections - Fix errors while preserving timestamps exactly
  4. Output corrected file - Return or save based on user's context

Strict Rules

Timeline Preservation
  • NEVER modify timestamps - Keep all 00:00:00,000 --> 00:00:00,000 lines exactly as-is
  • NEVER change subtitle numbering - Preserve sequence numbers
  • NEVER merge or split subtitle entries - One-to-one correspondence
Error Categories
1. Phonetic Errors (同音字/谐音错误)

Common in Chinese speech recognition:

  • 会话 ↔ 绘画 (huìhuà)
  • 元数据 ↔ 源数据 (yuán shùjù)
  • 本课 ↔ 本科 (běnkè)
  • 示例 ↔ 事例 (shìlì)
  • 实践 ↔ 时间 (shíjiàn)
2. Technical Term Errors

Speech recognition often fails on:

  • Framework names: LangChain, LangGraph, OpenAI, PyTorch, TensorFlow
  • Programming terms: API, SDK, runtime, checkpointer, middleware
  • Code identifiers: snake_case names, function names, class names
3. English-Chinese Mixed Content
  • Luncheon/lunch → langchain
  • open EI/open Email → OpenAI
  • land GRAPH → langgraph
  • a memory Server → MemorySaver

Convert spoken descriptions to proper format:

  • "underscore" → "_" in variable names
  • "dot" → "." in method calls
  • Recognize camelCase, snake_case, PascalCase patterns

User-Provided Terminology

When users provide a terminology list, use it as the primary reference for corrections:

用户提供的术语:LangChain,Agent,OpenAI,LangGraph

These terms indicate:

  • Expected proper spellings of technical terms
  • Context about the content domain
  • Hints for identifying speech recognition errors

Processing Strategy

For Long Files (>200 lines)
  1. Process in chunks using view_range parameter
  2. Maintain context across chunks
  3. Build complete corrected file incrementally
For Technical Content
  1. Identify the domain (AI/ML, web dev, etc.)
  2. Build mental model of expected terminology
  3. Apply domain-specific corrections consistently
Quality Checks

Before outputting:

  • Verify all timestamps unchanged
  • Verify subtitle count unchanged
  • Check terminology consistency throughout
  • Ensure no orphaned corrections (partial fixes)

Common Correction Patterns

Chinese AI/ML Course Content
ErrorCorrectionContext
蓝犬/蓝卷/LanternLangChainFramework name
绘画会话Session/conversation
拖/tourtoolTool concept
checkpoint组件checkpointer组件Memory component
源数据元数据Metadata
大约模型大模型Large model
中间键中间件Middleware
Show full SKILL.md (299 more words)Show less
Code Identifiers
SpokenWritten
user underscore 001user_001
thread underscore idthread_id
create underscore agentcreate_agent
runtime dot stateruntime.state

Output Format

When saving, use -corrected suffix:

  • Input: filename.srt
  • Output: filename-corrected.srt

Validation Script

Use scripts/subtitle_tool.py to validate and analyze subtitle files:

bash
# Validate corrected file preserves structure
python scripts/subtitle_tool.py validate original.srt corrected.srt

# Show word-level diff with colored output (default, changes only)
python scripts/subtitle_tool.py diff original.srt corrected.srt

# Show ALL entries (changed and unchanged) in terminal
python scripts/subtitle_tool.py diff original.srt corrected.srt --all

# Generate HTML diff report (recommended for review)
python scripts/subtitle_tool.py diff original.srt corrected.srt --html report.html

# Show simple line-based diff (original/corrected lines)
python scripts/subtitle_tool.py diff original.srt corrected.srt --simple

# Disable colors for piping to files
python scripts/subtitle_tool.py diff original.srt corrected.srt --no-color

# Analyze file for potential speech recognition errors
python scripts/subtitle_tool.py analyze input.srt --terms "LangChain,OpenAI"
Diff Output Formats
Terminal Output (Default)

Shows word-level changes with colors:

[1] 00:00:01,500 --> 00:00:04,500
  今天我们来学习[-Luncheon-]{+LangChain+}框架

[3] 00:00:08,000 --> 00:00:12,500
  我们可以用它来创建[-绘画-]{+会话+}应用程序
  • [-deleted-] - Text removed (shown in red in terminal)
  • {+added+} - Text added (shown in green in terminal)
  • Use --all to show unchanged entries too

Generates a full comparison report with:

  • All entries displayed (changed and unchanged)
  • Side-by-side columns: Original | Corrected | Diff View
  • Visual highlighting: Red strikethrough for deletions, green for additions
  • Summary statistics: Total entries, changed count, unchanged count
  • Jump links: Quick navigation to changed entries
  • Change indicators: Yellow dot marks changed rows
bash
python scripts/subtitle_tool.py diff original.srt corrected.srt --html diff_report.html

Then open diff_report.html in a browser.

Validation Workflow
  1. Before correction: Run analyze to identify potential errors
  2. After correction: Run validate to ensure structural integrity
  3. Review changes: Run diff --html report.html to generate a visual comparison report
Validation Checks
  • Entry count matches original
  • All timestamps unchanged
  • All sequence numbers preserved
  • No formatting corruption

Example Interaction

Interaction 1: User uploads file without terms

User: 帮我修正这个字幕文件

Claude:

在开始修正之前,请提供一些关键术语,帮助我更准确地识别语音识别错误:

1. **专有名词**:人名、品牌名、产品名
2. **技术术语**:框架、库、工具名称
3. **领域词汇**:行业特定词汇
4. **其他关键词**:视频中频繁出现的重要词汇

请用逗号分隔,例如:`LangChain, Agent, OpenAI`

User: LangChain, Agent, OpenAI, LangGraph, checkpointer

Claude:

收到以下术语:
- 技术框架:LangChain, LangGraph, OpenAI
- 技术概念:Agent, checkpointer

这是一个 LangChain 相关的技术教程。还有补充吗?

User: 没有了,开始吧

Claude: [Proceeds with correction workflow]

Interaction 2: User provides terms upfront

User: 帮我修正字幕,术语:LangChain, OpenAI, Agent

Claude: [Confirms terms, then proceeds directly]

Correction Process
  1. Read uploaded .srt file
  2. Run analyze to identify potential errors
  3. Apply corrections using provided terms as primary reference
  4. Run validate to confirm structural integrity
  5. Save corrected file with -corrected suffix
  6. Generate diff report and present summary of changes
  7. Offer HTML report: Ask user if they want an HTML diff report for easier review

Output: Provide categorized summary of corrections made.

After completion, prompt user:

修正完成!我可以生成一个 HTML 差异报告,方便您在浏览器中查看所有修改。
需要生成 HTML 报告吗?

Correction complete! I can generate an HTML diff report for easier review in your browser.
Would you like me to generate the HTML report?

© sugarforever, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in skills/subtitle-correction of sugarforever/01coder-agent-skills.

  • SKILL.md
  • references/srt-format.md
  • references/terminology.md
  • scripts/subtitle_tool.py

Open the folder on GitHubat commit e51fb6e

Compare with similar skills

Subtitle Correction 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.

Subtitle Correction compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Subtitle Correction this skillsugarforever/01coder-agent-skills136—~2.3kAutomated safety check: PassMIT
Proofreadsonilo-ai/skills1151 repos~4.3kAutomated safety check: NotesMIT
KrillinAI Subtitle Generatorkrillinai/OpenCreator13k1 repos~613Automated safety check: PassApache-2.0
Youtube PublishAndonywang123/Epost197—~3.4kAutomated safety check: WarnNone
Video TranslationNoizAI/skills526—~1.3kAutomated safety check: NotesNone
Check Metadata Styleowid/etl158—~4.4kAutomated safety check: PassMIT

Similar skills

  • Proofread

    sonilo-ai/skills

    Transcribe a video with Sonilo and translate the transcript into editable .srt files — one per target language, plus the detected source language — so the wording can be read and corrected before…

    115 GitHub starsUsed in 1 repo~4.3k tokens
    Media & CreativeAuto-check: notes
  • KrillinAI Subtitle Generator

    krillinai/OpenCreator

    Generates subtitles with the KrillinAI CLI from a YouTube link, Bilibili link or local video, with platform captions, Whisper fallback, translation and bilingual SRT output.

    13k GitHub starsUsed in 1 repo~613 tokens
    Media & CreativeAuto-check passed
  • Youtube Publish

    Andonywang123/Epost

    Prepare an English YouTube release with local Chinese-to-English translation, subtitles and cover localization, then use a deterministic script connected to dedicated Chrome and YouTube Studio to…

    197 GitHub stars~3.4k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: warnings
  • Video Translation

    NoizAI/skills

    Translate and dub videos from one language to another, replacing the original audio with TTS while keeping the video intact.

    526 GitHub stars~1.3k tokensUpdated 10 days ago
    Media & CreativeAuto-check: notes
  • Check user-facing indicator and chart metadata (titles, subtitles, descriptions, descriptionkey/WYSK, display names) against OWID's Writing and Style Guide, after a mechanical pass for whitespace…

    158 GitHub stars~4.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Transcribe DNA to RNA and translate to protein using Biopython, with NCBI codon-table selection, CDS validation, and six-frame ORF finding.

    1.2k GitHub starsUsed in 1 repo~3.4k tokens
    Media & CreativeAuto-check passed

More from sugarforever/01coder-agent-skills

All 21 skills in this repo
  • Typography Cover Designer

    sugarforever/01coder-agent-skills

    Designs typography-driven video covers and thumbnails in HTML/CSS and screenshots them with Chrome DevTools at 16:9, 16:10, 9:16 and 3:4.

    136 GitHub stars~3.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Mining Session Skills

    sugarforever/01coder-agent-skills

    Reviews one finished Claude Code session from its exported markdown and decides whether a skill is worth creating, updating or reusing for similar work.

    136 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Claude Session Exporter

    sugarforever/01coder-agent-skills

    Lists Claude Code session transcripts and exports them to organized Markdown with a digest, a clean conversation and linked tool-call details.

    136 GitHub stars~1.7k tokensUpdated 3 mo ago
    Auto-check passed
  • Codex Session Manager

    sugarforever/01coder-agent-skills

    Lists, filters and exports local Codex session transcripts to organized Markdown with a digest, timeline and tool-call details, in full or pick-one mode.

    136 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Diagram to Image Converter

    sugarforever/01coder-agent-skills

    Converts Mermaid diagrams and markdown tables into PNG images through a hosted rendering API, for platforms without rich formatting.

    136 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Audio and SRT to Narrated Video

    sugarforever/01coder-agent-skills

    Builds a narration-synced MP4 from a voiceover audio file and its SRT subtitles using HyperFrames, with scenes timed to the subtitle cues; instructions are in Chinese.

    136 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Subtitle Correction

What does Subtitle Correction do?

Fixes speech-recognition mistakes in .srt subtitle files, in Chinese or English, using terms you supply and leaving every timestamp untouched. Before any editing the agent asks for domain terms such as proper nouns, brands and technical vocabulary, then repeats the list back and names the likely domain, for example an AI course or web development. If you have no terms, it uses built-in patterns, flags the corrections it is unsure about and asks afterward whether it missed any.

When should I use Subtitle Correction?

Subtitle Correction fits situations like: proofreading .srt subtitles produced by automatic speech recognition; fixing technical terms in programming or AI course captions; correcting Chinese homophone errors without touching the timeline.

How do I install Subtitle Correction in Claude Code?

Run `npx skills add sugarforever/01coder-agent-skills --skill subtitle-correction -a claude-code`. Or copy the skill folder (skills/subtitle-correction in sugarforever/01coder-agent-skills) into .claude/skills/subtitle-correction in your project. Claude Code loads it when a task matches its description.

How do I install Subtitle Correction in Codex?

Run `npx skills add sugarforever/01coder-agent-skills --skill subtitle-correction -a codex`. Or copy the skill folder (skills/subtitle-correction in sugarforever/01coder-agent-skills) into .agents/skills/subtitle-correction in your project. Codex loads it when a task matches its description.

Can I use Subtitle Correction 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 sugarforever/01coder-agent-skills --skill subtitle-correction -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/subtitle-correction, .gemini/skills/subtitle-correction, .github/skills/subtitle-correction and .opencode/skills/subtitle-correction in your project.

What does Subtitle Correction need to run?

Going by SKILL.md and its folder, Subtitle Correction needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python to run the bundled subtitle_tool.py script.

Does Subtitle Correction access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Subtitle Correction 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 Subtitle Correction use?

Subtitle Correction is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Subtitle Correction use?

About 2.3k tokens (SKILL.md is roughly 9.2k 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 1.5k tokens, read only when the agent opens those files.

What are the alternatives to Subtitle Correction?

Skills that share tags, products or a category with Subtitle Correction: Proofread (sonilo-ai/skills, 115 stars), KrillinAI Subtitle Generator (krillinai/OpenCreator, 13k stars), Youtube Publish (Andonywang123/Epost, 197 stars) and Video Translation (NoizAI/skills, 526 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Subtitle Correction?

sugarforever (a GitHub user) maintains it in sugarforever/01coder-agent-skills, which has 136 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on June 19, 2026.

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