Subtitle Optimizer
Use when reviewing or correcting SRT subtitle text while preserving timestamps, especially ASR transcript errors, product-name terminology, homophone mistakes, and visual review workflows.
Install
npx skills add Rancho-7/subtitle-optimizer --skill subtitle-optimizergit clone --depth 1 https://github.com/Rancho-7/subtitle-optimizer.git /tmp/subtitle-optimizer
mkdir -p ~/.claude/skills
cp -r /tmp/subtitle-optimizer/. ~/.claude/skills/subtitle-optimizerPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# SRT 字幕文字优化
此 skill 用于优化 SRT 字幕文件中的文字内容,提高准确性,同时严格保留原始时间戳。所有实际写入最终 SRT 的修改都必须经过审查面板或用户明确确认。
## 核心概念
**词汇列表**(`assets/corrections.json`):包含已知需要修正的词汇对,支持两种匹配模式:
**普通模式(默认):**
```json
{"from": "cloud code", "to": "Claude Code", "reason": "产品名称"}
```
**正则模式(`regex: true`):** 用于处理多种变体,如大小写、空格差异:
```json
{"from": "cloud\\s?code", "to": "Claude Code", "reason": "产品名称", "regex": true}
```
- `cloud code` → Claude Code
- `cloudcode` → Claude Code(无空格)
- `Cloud Code` → Claude Code(大写)
常用正则语法:
- `\s?` — 可选空格
- `\s*` — 零或多空格
- `-?` — 可选连字符
- 大小写不敏感由脚本默认处理,不需要在规则中写 `(?i)`
## 工作流程
### 第一步:加载词汇列表
读取 skill 目录下的 `assets/corrections.json`,了解已知的修正规则。
### 第二步:读取并解析 SRT 文件
使用 Read 工具读取用户提供的 SRT 文件。SRT 格式结构:
```
1
00:00:01,000 --> 00:00:04,000
第一行字幕文本
2
00:00:05,000 --> 00:00:08,000
第二行字幕文本
```
解析要点:
- 序号(1, 2, 3...)
- 时间码(开始时间 --> 结束时间)
- 字幕文本(可有多行)
- 区块之间以空行分隔
### 第三步:分析字幕内容
逐一检查每个字幕条目,识别以下类型的问题:
**基于词汇列表的修正:**
- 遍历 `corrections.json` 中的每条规则
- 如果 `regex: true`,使用正则匹配(考虑大小写不敏感)
- 如果 `regex: false` 或省略,使用普通字符串匹配
- 匹配成功后标记待修正
**转录错误:**
- 同音字/近音字错误(如"未"vs"位"、"时"vs"是")
- ASR 识别错误
- 标点符号错误
**语义偏差:**
- 上下文理解错误
- 表述不够准确或完整
- 前后文不一致
**判断依据:**
- 句子语法和语义是否通顺
- 同一概念在多个字幕中的表述是否一致
- 是否符合常识和上下文语境
### 第四步:准备候选 SRT 和审查面板
先从 skill 目录运行 `prepare-review`。它会读取原始 SRT 和词汇列表,在原始 SRT 同目录生成:
- `{原文件名}_candidate.srt`
- `{原文件名}_diff_preview.html`
```bash
node scripts/generate_diff.js prepare-review \
/path/to/video.srt \
--corrections assets/corrections.json
```Details
- Skill name
subtitle-optimizer- Repository
- Rancho-7/subtitle-optimizer
- License
- MIT
- Repo updated
- 17 April 2026
FAQ
What does the Subtitle Optimizer skill do?
Use when reviewing or correcting SRT subtitle text while preserving timestamps, especially ASR transcript errors, product-name terminology, homophone mistakes, and visual review workflows.
How do I install the Subtitle Optimizer skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add Rancho-7/subtitle-optimizer --skill subtitle-optimizer. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Subtitle Optimizer popular?
It lives in Rancho-7/subtitle-optimizer, which has 6 GitHub stars and 2 forks.
Related skills
Arch Render
7dakhlallah/arch-render
Create, improve, review, and present architectural still imagery while preserving the supplied design. Use for architectural render prompts, direct photorealistic rendering, material or lighting edits, style-reference matching, image enhancement, consistent render sets, design critique, presentation boards, architectural portfolios, typology guidance, and architect-level coordination advice. Accept sketches, plans, elevations, sections, physical models, photos, and screenshots from SketchUp, Revit, Rhino, D5, Lumion, Enscape, Blender, V-Ray, or similar tools. Produce all user-facing instructio
Script to Guide
6SilverNine/script-to-guide
Turn a written script and real app screenshots into a narrated product walkthrough. Output is a small static web page (searchable transcript, follow-along mode, embeds with an iframe) or an MP4. Every highlight, zoom and cursor move is cued to a word of the synthesized narration, so editing the script re-times the screen. Use when the user wants a product guide, onboarding walkthrough, feature tutorial or help-center video for a web app, or for any app from screenshots.
Product Video
7kritikmodi/product-video-as-code
Produce product videos end to end - product demos, feature launches, explainers, walkthroughs, tutorials, release notes, onboarding and social cuts - from a script, an AI voiceover, animated HTML slides and real screen recordings, rendered deterministically to MP4 with ffmpeg. Use when asked to create, edit, re-cut, re-voice, shorten or re-brand any video about software.
Muse Gadget Forge
6Toddoward/muse-gadget-forge
Build your own Muse gadget — your ears and voice in the user's room — on the user's own computer: set up ESP-IDF on the muse-local-gateway workbench, build the Muse Gadget SDK firmware, flash the ESP32 board on their USB port, read its log, and walk the user through pairing. Use when the user wants a new or updated Muse gadget, or one that misbehaves.
Static to Video Ad Complete
7holy-templar/static-to-video-ad
v1.0 — Unified two-path skill that turns ANY static ad into video on the MaxFusion AI MCP, opening with a gate that asks which treatment the user wants. PATH A — ANIMATE THE STATIC AD: a real human hand enters frame and physically organizes the ad's elements one by one in photorealistic live-action (real physics, natural shadows, smooth human motion — never stop-motion) over 0-4s, non-text elements only; then every text block animates in cleanly at the end and the finished ad holds — 6 seconds, Google Omni locked. PATH B — MAKE A VIDEO AD: the static becomes the ENDING of a live-action clip —
Generate
6AntonioCardenas/generate-nanobanana
Generate images and videos using Google's Gemini media models (Nano Banana 2 Lite, Nano Banana 2, Nano Banana Pro, Gemini Omni Flash) via the Gemini API. Use this whenever the user asks to generate, create, or make an image or video, wants a thumbnail, wants to animate a still image, says "generate on brand" or "generate from reference", wants to link or import a folder of reference images, invokes /generate or /generate frf, or asks to update this skill ("/generate update") — even if they don't name a specific model, and even if they just describe a visual they want without saying "generate.
Browse the most popular Claude skills, all images, video & audio skills, or write your own with the skills generator.