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.

6 stars 2 forksImages, Video & Audio

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Rancho-7/subtitle-optimizer --skill subtitle-optimizer
Manual install
git 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-optimizer

Personal 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
```
Read the full skill on GitHub

Details

Skill name
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

7

dakhlallah/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

Images, Video & Audio

Script to Guide

6

SilverNine/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.

Images, Video & Audio

Product Video

7

kritikmodi/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.

Images, Video & Audio

Muse Gadget Forge

6

Toddoward/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.

Images, Video & Audio

Static to Video Ad Complete

7

holy-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 —

Images, Video & Audio

Generate

6

AntonioCardenas/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.

Images, Video & Audio

Browse the most popular Claude skills, all images, video & audio skills, or write your own with the skills generator.