JimLiu/baocut
GitHub: JimLiu/baocut
为 AI 编程助手提供驱动 BaoCut macOS 视频处理应用 CLI 的 Agent 技能,通过自然语言即可完成视频转写、字幕翻译与导出。
Stars: 181 | Forks: 10
# BaoCut agent skill
赋予你的 AI 编程 agent 驱动 **[BaoCut](https://baocut.app)** 的能力 —
转写、添加并翻译字幕、查看发言人、清理“头部特写 (talking-head)”
视频,并进行导出 —— 所有这些都只需通过自然语言完成。这是一个开源的
[Agent Skill](https://skills.sh),封装了 `baocut` 命令行工具。
兼容 **Claude Code**、**Codex** 以及任何兼容 [skills.sh](https://skills.sh) 的 agent。
## 环境要求
- **macOS** — BaoCut 是一款 Mac 应用。
- **BaoCut 应用** — 从 **[baocut.app](https://baocut.app)** 安装。该
skill 驱动的是 `BaoCut.app` 内部捆绑的 CLI;它本身不包含底层引擎。
- **Node.js** — 仅用于下方的一键安装命令
([下载](https://nodejs.org/en/download))。手动安装步骤则不需要 Node。
## 安装说明
### 推荐 — skills.sh
```
npx skills add JimLiu/baocut -g -a claude-code codex -y
```
这会将该 skill 全局安装到 `~/.agents/skills/baocut` 并为
Claude Code 和 Codex 建立链接。
### 手动安装 (无需 Node.js)
```
git clone https://github.com/JimLiu/baocut.git ~/.agents/skills/baocut-src
ln -sfn ~/.agents/skills/baocut-src/skills/baocut ~/.agents/skills/baocut
# 为你使用的每个 agent 链接它,例如 Claude Code:
mkdir -p ~/.claude/skills
ln -sfn ~/.agents/skills/baocut ~/.claude/skills/baocut
```
## 使用方法
安装完成后,只需向你的 agent 发出指令 —— 例如:
- **Claude Code** — "Transcribe and translate the subtitles of `talk.mp4` to
Chinese," 或中文的“转写并翻译字幕”。你也可以输入 `/baocut`。
- **Codex** — 在你的 prompt 中引用 baocut skill;它会驱动 `baocut` CLI。
在底层,agent 会运行如下命令:
```
baocut --json auto talk.mp4 --lang zh # transcribe -> polish -> translate
baocut export --srt --translated --lang zh
```
如果 `baocut` 不在你的 PATH 中,请使用内置的解析器
`skills/baocut/bin/baocut`(它会指向 `/Applications/BaoCut.app/Contents/MacOS/baocut-cli`,
并在应用缺失时提示你进行安装)。
## 目录结构
```
skills/baocut/
SKILL.md # agent entry point (router)
references/ # per-task guides (orchestration, editing, export, …)
bin/baocut # resolves the CLI inside the installed BaoCut.app
```
## 相关链接
- 应用与文档 — [baocut.app](https://baocut.app)
- skills.sh — [skills.sh](https://skills.sh)
## 许可证
[MIT](LICENSE)。
标签:Agent技能, AI智能体, MITM代理, 字幕翻译, 视频处理, 语音转写