wdkns avatar

Subtitle Refine

This does production-grade cleanup of Chinese ASR subtitles without turning them into polished prose. It fixes recognition errors, strips filler words like 嗯 and 啊, adds spacing between clauses, and splits entries over 14 characters while keeping everything synced to the original audio timestamps. The workflow is conservative: no rewriting for style, no summarizing, just subtitle-level fixes. It includes a validation script that checks length limits, timeline drift, and deletion allowlists. Best for documentaries, interviews, or screencasts where you need to correct ASR output but preserve the speaker's natural phrasing. The instructions are unusually thorough about not introducing timeline drift when splitting entries, which is where most automated cleanup tools fail.

skills.sh installs
325
GitHub stars
827
last updated
Aug 21, 2026

Install

$ npx -y skills add wdkns/wdkns-skills --skill subtitle-refine --agent claude-code

Installs into .claude/skills of the current project.

Files

字幕精修

任务目标

把用户提供的原始 srt 清洗成一份可交付的完整 clean.srt。

  • 不要覆盖原始字幕文件。
  • 只做字幕级纠错,不做润色、总结或扩写。
  • 最终校验:直接对原始 srt 和完整 clean.srt 运行 scripts/check_clean_srt.py。

原始要求

文本清洗要求

  1. 修正识别错误,包括正确的“的地得”、合理的“他她它”。
  2. 删除“嗯、啊、呃、哈”之类的无意义语气词;清洗后的字幕不要带标点。
  3. 子句间需要有必要的空格停顿。 例:来那你就先开始 -> 来 那你就先开始 例:你是第二个是吧 -> 你是第二个 是吧
  4. 删除明显重复字眼,不要书面化改写,不要总结,不要扩写,只做字幕级清洗和纠错。
  5. 每条字幕最长不超过 14 字(英文单词默认视为一个字),单条字幕内不要换行。
  6. 如果原字幕超过 14 字,要做准确断句拆分。 例:还得谢谢各位母亲对家里的付出 -> 还得谢谢各位母亲 + 对家里的付出
  7. 不得因文本纠错、删语气词、删重复字眼或拆分字幕,造成后续字幕整体提前或滞后。所有调整都应限于当前字幕条目及其局部范围内。

时间轴要求

  1. 处理后字幕必须与原音频严格同步,不得出现全局时间漂移。
  2. 若仅进行字幕级清洗与纠错,且未改变原句语义边界,则默认保持该条原始起止时间不变。
  3. 若因断句或单条超过 14 字而拆分,则拆分后的所有子条目必须完全落在原字幕时间范围内;各子条目之间不得重叠,优先首尾衔接,总覆盖时长必须与原条目一致。
  4. 拆分后的时间分配应优先依据语义停顿和说话节奏;无法精确判断时,再按各子句有效字符数比例分配,不得机械平均切分。
  5. 删除句中语气词或明显重复字眼时,通常不调整原条目起止时间;若某条本身只是独立且无意义的语气词,则可直接删除,但不得无依据拉伸前后字幕覆盖。
  6. 每条字幕应尽量贴合语音片段,不得明显早挂或滞留;如需微调,单条字幕起止时间相对语音边界的偏差应尽量控制在 ±100 到 150 毫秒内。
  7. 拆分和删改后仍须保证可读性,避免过短闪现、明显漏挂、无意义空窗或破坏自然语义边界的切分。

额外要求

  1. 不要误删有意义的字幕条目。
  2. 时间轴必须 double check。
  3. 如果字幕文件过长,只有在用户明确要求并行或允许并行子代理时才并行;即便并行,也只把并行当作编辑辅助,主代理最后仍需直接整理出一份完整的 clean.srt。
  4. 脚本不应假设字幕一定发生了拆分;无拆分和有拆分都必须兼容。

工作原则

Sponsors

Details

Repository
github.com/wdkns/wdkns-skills
Category
Video & Audio Editing
First seen
Jun 3, 2026

More from wdkns/wdkns-skills

All 3
1onewave-ai avatarpodcast-to-content-suiteonewave-ai/claude-skillsTransform podcast transcripts into comprehensive content marketing suites including blog posts, social media content, newsletters, SEO-optimized articles, and t321skills.sh installs
2onewave-ai avatarsports-podcast-outline-generatoronewave-ai/claude-skillsCreate structured podcast episodes. Segment timing, debate points, hot takes, listener questions, ad break placement.315skills.sh installs
3bytedance avatarbyted-las-video-editbytedance/agentkit-samples智能视频剪辑:用自然语言描述要保留的片段/人物/事件,自动从长视频抽取剪辑(可用参考图做人物/物体匹配)。当用户要按描述找片段、提取高光或做智能剪辑时触发。211skills.sh installs
4charleswiltgen avataraxiom-ui-recordingcharleswiltgen/axiomUse when setting up UI test recording in Xcode 26, enhancing recorded tests for stability, or configuring test plans for multi-configuration replay. Based on WW169skills.sh installs
5opensensenova avatarsn-da-image-captionopensensenova/sensenova-skills图片理解与数据提取 skill。当图片文件(.png/.jpg/.jpeg/.gif/.webp/.bmp)是主要输入且用户需要理解、提取数据或分析图片内容时使用。提供预配置的 caption 脚本(scripts/caption.py),通过 vision 模型将图片转为文本描述,无需额外配置 API Key。覆盖:143skills.sh installs
6dtsola avatarvideo-podcast-makerdtsola/xiaoyaosearchThis is a full production pipeline that takes a topic and outputs a 4K video podcast through research, scripting, TTS, and Remotion...0skills.sh installs