claude-skills

我（王建硕）日常在 Claude Code 里用的 skills。

Auto-mirrored from ~/.claude/skills/ by a PostToolUse hook —
每次我编辑 wjs-* skill，对应目录会被 rsync 到这里并推送到 GitHub。
Hook 源码：~/.claude/skills-publish-hook.sh

前置:安装 Claude Code / Install Claude Code

这些 skill 跑在 Claude Code 里,所以先装 Claude Code。

# 方式 1:npm 全局安装(推荐,需要 Node.js ≥ 18)
npm install -g @anthropic-ai/claude-code
claude            # 启动

# 方式 2:不装,直接用 npx 跑一次
npx @anthropic-ai/claude-code

# 方式 3:原生安装脚本(无需 Node.js)
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

装好后在任意项目目录运行 claude 即可。首次启动会引导登录(Claude 账号或 API key)。
升级:claude update(原生安装)或 npm update -g @anthropic-ai/claude-code(npm 安装)。

安装 Skills / Install Skills

# 方式 1:从 ClawHub 装单个 skill
clawhub install wjs-transcribing-audio

# 方式 2:把整个仓库作为 Claude Code marketplace
claude plugin marketplace add jianshuo/claude-skills
claude plugin install wjs-transcribing-audio

# 方式 3:直接 clone 到 skills 目录
git clone https://github.com/jianshuo/claude-skills ~/.claude/skills/wjs

兼容性 / Compatibility

SKILL.md 是 Anthropic 公开的 skill 格式标准（2025 年 10 月发布，2025 年 12 月被 OpenAI Codex 采纳），所以这套 skill 同样适用于:

• Claude Code — 主要测试和使用环境
• OpenAI Codex CLI — 2025-12+ 起兼容
• Cursor / Gemini CLI / Goose — 生态在跟进

第三方分发平台:ClawHub · SkillsMP（自动索引）

这些 skill 是什么？

Claude Code skill 是一个带 frontmatter 的 SKILL.md 文件 + 一组脚本。当用户的请求匹配 skill 描述里的触发词（"翻译字幕"、"做封面"、"上传 YouTube"……）时，Claude 会自动加载这个 skill 并按里面写的流程执行。

这套 skill 大致围绕 「视频创作 + 公众号写作」 工作流：从原始拍摄素材 → 多机位对齐 → 自动剪辑 → 翻译配音 → 后期合成 → 平台分发。每个 skill 都做一件事，可以单独调用，也可以串成完整流水线。

命名约定：所有 skill 以 动名词（V-ing） 开头 —— transcribing-audio / dubbing-video / editing-multicam —— 描述「正在做什么动作」，方便和 Claude 自动加载逻辑对齐。

安装 & 使用 / How to Install

把任意一个 skill 目录复制到 Claude Code 的 skills 目录即可：

# 全局安装（所有项目都能用）
cp -r wjs-transcribing-audio ~/.claude/skills/

# 项目级安装（只在当前项目可用）
cp -r wjs-transcribing-audio ./.claude/skills/

装好后用触发词自然说话（如「转写这个视频」、「做 SRT」），或用斜杠命令 /wjs-transcribing-audio 显式调用。不需要重启 Claude Code，技能即时生效。

Skills 总览

1. 公众号 / WeChat

wjs-publishing-wechat

帮我写 / 润色微信公众号文章，并自动生成配套素材。

• 轻润色，不重写。 保留作者语气和节奏，只改错字、调段落、抚平特别拗口的句子。
• 自动生成 题图（cover） 和 解释图（illustration）。
• 自动生成标题候选、摘要、可直接粘贴到 mp.weixin.qq.com 的 HTML。
• 通过 md2wechat 上传草稿到公众号后台。

触发词：写一篇微信文章 / 公众号 / 润色 / 题图 / 发公众号

2. 视频本地化 — 字幕 + 翻译 + 配音

一条 「转写 → 翻译 → 配音 → 烧字幕」 的四步流水线。每一步都是独立 skill，可以单独跑，也可以让 wjs-localizing-video 这个 orchestrator 串起来跑完整流程。

wjs-transcribing-audio

中文走豆包（Volcano）ASR，其它语言走 OpenAI Whisper word-level timestamps + 自己重新组装 cue。所有 cue 都按标点切，避免句子被切到一半。

wjs-translating-subtitles

纯文本，不碰音视频。简体中文 / 英文是 first-class targets。重切逻辑保证每条字幕都在真正的句号 / 问号 / 感叹号处结束。可输出单语 SRT 或双语 SRT。

wjs-dubbing-video

按 voice ID 路由：中文 → 豆包 TTS，其它语言 → edge-tts neural。默认单说话人，opt-in 视觉 diarization 做多说话人多音色。只产出 dub 音轨，不做最终合成。

wjs-burning-subtitles

本地化流水线的终点。一次 ffmpeg 编码同时做：烧字幕（libass）、把 dub 混进来、把原音降低音量作为底噪保留。不走级联——避免多次重编码掉画质。当 Homebrew 的 ffmpeg 不带 libass 时，会自动下载 evermeet 的静态构建。

wjs-localizing-video（orchestrator）

当用户说 「完整本地化」 时用这个总编排器。单步需求请直接用上面四个之一 —— boundary 更清楚也更快。

3. 多机位拍摄 → 自动剪辑

wjs-syncing-multicam

同一事件、不同设备拍的 N 路素材，用 音频互相关 算出每个文件相对共同时间轴的偏移。

• 关键设计：sidecar over re-encode。 不生成 _synced.MOV，只输出每个原始文件旁边一份 .sync.json。原片永不被改写、不被复制、不被重编码。
• 75 分钟 3 机位 4K 拍摄 = 60+ GB，重编码同步会让磁盘翻倍且画质下降。Sidecar 是无损可逆元数据。
• 下游用 ffmpeg -itsoffset 在消费侧应用偏移。

wjs-editing-multicam

读 sidecar，自动剪辑成单条 MP4。决策完全由 每秒音频能量 驱动 —— 哪个机位的麦最响，就切到哪个。

• 硬切（无 crossfade）+ 可选的 picture-in-picture 小窗。
• 音频取自被选中那个机位的麦（不做多麦克风 mix）。
• 不做人脸 / 取景识别 —— 那是 wjs-overlaying-video 或 HyperFrames 的事。

4. 长视频拆条 + 后期 + 横竖屏

wjs-segmenting-video

长访谈 / 讲座 / 播客 → 3–6 段独立可看的短片。

5 步流水线（每步也能独立跑）：

1. Agent 读 SRT 决定话题边界
2. Stream-copy 切原视频（不重编码）
3. 给每个 clip 用 gpt-image-2 生成封面（标题烤进图里）
4. 把封面作为 1.5 秒 title card 拼到 clip 前面
5. libass 烧字幕

只做切 + 裁 —— 封面 / 字幕 / 动画 / CTA 交给下游 wjs-overlaying-video。

wjs-overlaying-video

视频后期。基于 HyperFrames —— 一个 HTML/CSS 的视频合成框架。在同一份 HyperFrames 工程里加：

• AI 生成封面作为首帧
• HTML/CSS captions（kinetic、逐词高亮、自定义字体）按 SRT 同步
• hook moment 的 kinetic illustration
• 章节 chip / 片尾 CTA / lower-thirds

所有元素在一次最终编码里渲染，不做级联。

wjs-reframing-video

横竖屏互转 —— 裁切 而不是缩放或加黑边。

• 16:9 → 9:16（发抖音 / 视频号 / 小红书 / YouTube Shorts / TikTok / Reels）
• 9:16 → 16:9（竖屏手机视频转横屏播客）
• 4:3 ↔ 3:4 也支持
• 用 MediaPipe FaceLandmarker + 嘴部张合度方差找 真正在说话 的人（不是最大或最 confident 的脸）
• 段落间 硬切，不做 smooth pan（更像真人剪辑）
• 输出 .crop.json 记录裁切计划，原片不动

5. 分发 / 上传 / 推广

wjs-uploading-video

批量上传成片到 YouTube（王建硕频道）。

• 读取 sibling UPLOAD_META.md 拿每个视频的 title / description / tags（用户自定义的 markdown 格式）
• 在 SOCKS/HTTP 代理后能用 —— 直接走 requests 做 resumable upload，避开 google-api-python-client 的 MediaFileUpload 在该代理下卡死的问题
• 不支持微信视频号（无公开 API）/ 抖音 / 小红书 / B 站

wjs-promoting-skills

每天 04:00 自动推广 skill：挑一个 wjs-* skill → 生成今日推广角度 → 发到 X（Twitter）→ 把 Reddit / HN / Discord 草稿落到 outbox/ 等人工 review。

• X 真发，社区只起草。 Reddit / HN 没有可靠的自动发帖 API，不冒封号风险。
• Idempotent + 节流：同一 skill 7 天内不重复推；当天没改动的 skill 跳过；每天最多 1 条 X。
• 角度轮换：同一 skill 会从「具体痛点 → 反直觉设计决策 → 串联工作流 → 最近更新」四个维度循环。
• DRY_RUN=1 daily.sh 可以预览而不真发；uninstall.sh 随时停掉 launchd 定时任务。

触发词：推广 skills / skill marketing / promote my skills / 每天自动推广

6. 项目体检 / 反思 / 自我维护

wjs-auditing-project

当我说 "看看项目出了什么问题" / "为什么用户的需求还没上线" / "为什么没提交 App Store"，跑这个 skill。

• 硬性两阶段：先 read-only 巡检 → 给我一份分组 checklist；我确认之后才动手修。
• 覆盖：未合并分支、停滞的 PR、失败的 GitHub Actions、过期的 build、TODOS.md / ROADMAP 漂移、未发布的 commit、日志里的 error。
• 知道我的 Cathier iOS app 工作流（Xcode + fastlane + @claude PR auto-merge）。

wjs-eating-and-growing（吃一堑长一智）

当我反思一个失误、反复犯的错，或者"知道道理但做不到"，走这六步。

• 底层框架：L1（不知道）/ L2（知道但临场来不及）/ L3（本能赢了）—— 三层完全不同，用错修法等于练了寂寞。
• 一步一问，不可跳：每步只问一个问题等回答再走下一步。跳步会让复盘变成又一条 L1 笔记。
• 六步：① 现场标注（把那个温度找回来）→ ② 根因 → ③ 层位诊断 → ④ 选修法 → ⑤ 排频次 → ⑥ Fire-test（诚实检验下次会不会真的变）。
• 最终输出：一个 block，6 行，任何一行还是模糊的说明没走完。

触发词：反思 / 复盘 / 吃一堑 / 这次又栽了 / 为什么我总是… / 知道道理但做不到

典型工作流串接

完整本地化一个西班牙语播客 → 中文版上 YouTube：

源视频
  └─ wjs-transcribing-audio       → 西语 SRT
      └─ wjs-translating-subtitles → 中文 SRT
          └─ wjs-dubbing-video      → 中文配音的视频
              └─ wjs-burning-subtitles → 烧字幕 + 混音 → 最终 MP4
                  └─ wjs-uploading-video → YouTube

或者一句话：/wjs-localizing-video 把上面四步串起来跑。

双机位访谈 → 抖音 + YouTube 双版本：

两路 MOV
  └─ wjs-syncing-multicam         → 两份 .sync.json
      └─ wjs-editing-multicam     → 单条 16:9 MP4
          ├─ wjs-segmenting-video → 4 个独立话题 clip
          │   └─ wjs-overlaying-video → 加封面 + 字幕 + CTA
          │       └─ wjs-uploading-video → YouTube
          └─ wjs-reframing-video  → 9:16 竖屏版本 → 视频号 / 抖音

写公众号文章：

草稿 → wjs-publishing-wechat → 题图 + 解释图 + HTML + 上传草稿 → mp.weixin.qq.com 后台微调发布

如何贡献 / Contributing

欢迎提 Issue 或 PR。新增 skill 的要求：

1. 目录名用 V-ing 动名词（如 wjs-doing-something），加 wjs- 前缀与本仓库风格保持一致。
2. 目录内放一个 SKILL.md，frontmatter 里写 name 和 description（含具体触发词/例句），正文写清楚 when to use / when NOT to use / 执行步骤。
3. 需要的脚本放同目录下。
4. 提 PR，在 PR 描述里说明 skill 的用途和触发词。

有问题或建议，请到 Issues 反馈。