Skip to content

JimLiu/baocut / skills/baocut

baocut

Flagged

用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut 视频时用;只翻译纯文本、与视频无关的写作或作图、别的剪辑器与 FFmpeg 的用法、BaoCut 源码开发不用。

FileKindSize
SKILL.mdskill md46.5 KB
built-in-skills/README.mdmarkdown9.6 KB
references/catalog/editing.mdmarkdown24.4 KB
references/catalog/export.mdmarkdown6.6 KB
references/catalog/media.mdmarkdown45.1 KB
references/catalog/models.mdmarkdown7.9 KB
references/catalog/music.mdmarkdown17.1 KB
references/catalog/subtitles.mdmarkdown20.8 KB
references/catalog/system.mdmarkdown9.6 KB
references/catalog/voice-gemini-tts.mdmarkdown2.6 KB
references/catalog/voice-language-rates.mdmarkdown6.5 KB
references/catalog/voice.mdmarkdown12.3 KB
references/catalog/web.mdmarkdown10.9 KB
references/conventions.mdmarkdown16.1 KB
references/craft/.gitkeepother0 B
references/craft/README.mdmarkdown480 B
references/craft/character-animation.mdmarkdown6.8 KB
references/craft/character-animation/examples/mini-film/art.example.jsonconfig918 B
references/craft/character-animation/examples/mini-film/index.htmlother628 B
references/craft/character-animation/examples/mini-film/scene.jsscript2.1 KB
references/craft/character-animation/references/art.mdmarkdown4.6 KB
references/craft/character-animation/references/checks.mdmarkdown2.6 KB
references/craft/character-animation/references/rig.mdmarkdown5.3 KB
references/craft/character-animation/references/style-and-story.mdmarkdown5.0 KB
references/craft/character-animation/references/timing-and-sound.mdmarkdown3.1 KB
references/craft/character-animation/rig-kit/rig-kit.jsscript33.0 KB
references/craft/character-animation/scripts/cutout.mjsscript26.9 KB
references/craft/character-animation/scripts/jump-scan.mjsscript3.2 KB
references/craft/character-animation/scripts/place-sfx.mjsscript5.1 KB
references/craft/character-animation/scripts/rig-check.mjsscript8.9 KB
references/craft/clip-montage.mdmarkdown11.5 KB
references/craft/clip-montage/references/assembly.mdmarkdown5.0 KB
references/craft/clip-montage/references/sourcing.mdmarkdown6.3 KB
references/craft/clip-montage/references/structure.mdmarkdown3.8 KB
references/craft/cover-and-title.mdmarkdown5.6 KB
references/craft/cross-video-qa.mdmarkdown5.8 KB
references/craft/design-system.mdmarkdown18.5 KB
references/craft/design-system/references/cover.mdmarkdown6.9 KB
references/craft/design-system/references/craft.mdmarkdown8.8 KB
references/craft/design-system/references/demo.jsonconfig161.1 KB
references/craft/design-system/references/format.mdmarkdown18.6 KB
references/craft/design-system/references/from-code.mdmarkdown11.5 KB
references/craft/design-system/references/from-design-tool.mdmarkdown16.2 KB
references/craft/design-system/references/sample-seazar-tokens.jsonconfig11.0 KB
references/craft/design.mdmarkdown19.3 KB
references/craft/design/references/brand-colors.mdmarkdown2.4 KB
references/craft/design/references/brand-typography.mdmarkdown1.7 KB
references/craft/design/references/craft.mdmarkdown15.4 KB
references/craft/design/references/design-system-components.mdmarkdown11.8 KB
references/craft/design/references/diagrams.mdmarkdown10.1 KB
references/craft/design/references/format.mdmarkdown11.8 KB
references/craft/design/references/print.mdmarkdown5.6 KB
references/craft/design/references/questions.mdmarkdown4.7 KB
references/craft/design/references/view-state.mdmarkdown5.7 KB
references/craft/docs.mdmarkdown19.9 KB
references/craft/docs/references/comments.mdmarkdown4.4 KB
references/craft/docs/references/editing.mdmarkdown12.9 KB
references/craft/docs/references/tabs.mdmarkdown4.7 KB
references/craft/docs/references/uploads.mdmarkdown1.7 KB
references/craft/explainer-video.mdmarkdown23.4 KB
references/craft/explainer-video/references/3d.mdmarkdown5.9 KB
references/craft/explainer-video/references/footage.mdmarkdown9.6 KB
references/craft/explainer-video/references/length-and-pace.mdmarkdown6.7 KB
references/craft/explainer-video/references/script.mdmarkdown14.7 KB
references/craft/explainer-video/references/subject.mdmarkdown12.5 KB
references/craft/history-video.mdmarkdown20.6 KB
references/craft/history-video/references/brief.mdmarkdown5.1 KB
references/craft/history-video/references/forms.mdmarkdown11.2 KB
references/craft/history-video/references/old-recordings.mdmarkdown12.4 KB
references/craft/history-video/references/self-check.mdmarkdown5.3 KB
references/craft/history-video/references/sources.mdmarkdown5.9 KB
references/craft/motion-graphics.mdmarkdown17.3 KB
references/craft/motion-graphics/exemplars/big-number/16x9.htmlother11.4 KB
references/craft/motion-graphics/exemplars/big-number/9x16.htmlother11.5 KB
references/craft/motion-graphics/exemplars/callout-pin/16x9.htmlother11.6 KB
references/craft/motion-graphics/exemplars/callout-pin/9x16.htmlother11.6 KB
references/craft/motion-graphics/exemplars/keyword-caption/16x9.htmlother11.3 KB
references/craft/motion-graphics/exemplars/keyword-caption/9x16.htmlother11.3 KB
references/craft/motion-graphics/exemplars/logo-sting/16x9.htmlother12.1 KB
references/craft/motion-graphics/exemplars/logo-sting/9x16.htmlother12.1 KB
references/craft/motion-graphics/exemplars/lower-third/16x9.htmlother11.2 KB
references/craft/motion-graphics/exemplars/lower-third/9x16.htmlother11.2 KB
references/craft/motion-graphics/references/audio-backdrop.mdmarkdown22.9 KB
references/craft/motion-graphics/references/grammar.mdmarkdown11.1 KB
references/craft/motion-graphics/scaffold.htmlother9.0 KB
references/craft/motion-graphics/scripts/build-bundle.mjsscript25.2 KB
references/craft/narration.mdmarkdown11.1 KB
references/craft/polish-transcript.mdmarkdown13.8 KB
references/craft/production-scripts.mdmarkdown15.7 KB
references/craft/production-scripts/references/pipeline.mdmarkdown37.8 KB
references/craft/production-scripts/scene-kit/geo110.jsscript27.3 KB
references/craft/production-scripts/scene-kit/scene-kit.jsscript38.3 KB
references/craft/production-scripts/scripts/align.mjsscript11.6 KB
references/craft/production-scripts/scripts/assemble.mjsscript26.4 KB
references/craft/production-scripts/scripts/build.mjsscript18.1 KB
references/craft/production-scripts/scripts/captions.mjsscript18.6 KB
references/craft/production-scripts/scripts/clips.example.jsonconfig3.2 KB
references/craft/production-scripts/scripts/coverage.mjsscript10.0 KB
references/craft/production-scripts/scripts/envelope.mjsscript2.9 KB
references/craft/production-scripts/scripts/explainer.example.jsonconfig2.2 KB
references/craft/production-scripts/scripts/fonts.mjsscript7.0 KB
references/craft/production-scripts/scripts/frames.mjsscript7.7 KB
references/craft/production-scripts/scripts/gaps.mjsscript11.3 KB
references/craft/production-scripts/scripts/host.mjsscript14.8 KB
references/craft/production-scripts/scripts/legibility.mjsscript5.7 KB
references/craft/production-scripts/scripts/level.mjsscript9.2 KB
references/craft/production-scripts/scripts/lib.mjsscript19.3 KB
references/craft/production-scripts/scripts/overlay.mjsscript34.7 KB
references/craft/production-scripts/scripts/preview.mjsscript4.6 KB
references/craft/production-scripts/scripts/quotes.mjsscript7.4 KB
references/craft/production-scripts/scripts/sources.mjsscript6.2 KB
references/craft/production-scripts/scripts/srt.mjsscript5.8 KB
references/craft/production-scripts/scripts/voice.mjsscript7.7 KB
references/craft/shorts-segments.mdmarkdown30.8 KB
references/craft/slides.mdmarkdown13.8 KB
references/craft/slides/references/design-system.mdmarkdown6.3 KB
references/craft/slides/references/design.mdmarkdown9.3 KB
references/craft/slides/references/format.mdmarkdown12.2 KB
references/craft/slides/references/images.mdmarkdown4.2 KB
references/craft/speaker-labeling.mdmarkdown6.6 KB
references/craft/subtitle-workflow.mdmarkdown13.1 KB
references/craft/talking-head-cut.mdmarkdown9.3 KB
references/craft/talking-head-cut/references/picture-and-sound.mdmarkdown10.1 KB
references/craft/titles-and-description.mdmarkdown5.2 KB
references/craft/titles-and-description/references/description.mdmarkdown5.1 KB
references/craft/titles-and-description/references/titles.mdmarkdown5.5 KB
references/craft/titles-and-description/references/writing-baseline.mdmarkdown11.9 KB
references/craft/translate-subtitles.mdmarkdown13.4 KB
references/craft/video-blog.mdmarkdown17.1 KB
references/craft/video-blog/references/writing-baseline.mdmarkdown11.9 KB
references/craft/video-chapters.mdmarkdown9.7 KB
references/craft/video-production.mdmarkdown31.9 KB
references/craft/video-production/examples/bundle-preview.htmlother17.7 KB
references/craft/video-production/examples/post-fx.jsscript7.5 KB
references/craft/video-production/references/code-scenes.mdmarkdown31.9 KB
references/craft/video-production/references/shot-plan.mdmarkdown5.1 KB
references/craft/video-production/references/sound-design.mdmarkdown4.4 KB
references/craft/video-production/references/visuals.mdmarkdown19.7 KB
references/craft/video-summary.mdmarkdown22.8 KB
references/craft/video-summary/references/writing-baseline.mdmarkdown11.9 KB
references/craft/virtual-host.mdmarkdown14.9 KB
references/craft/virtual-host/examples/character-partmap.example.jsonconfig600 B
references/craft/virtual-host/examples/character.example.jsonconfig336 B
references/craft/virtual-host/references/art.mdmarkdown22.1 KB
references/craft/virtual-host/references/hosts.mdmarkdown4.4 KB
references/craft/virtual-host/references/lipsync.mdmarkdown10.1 KB
references/craft/virtual-host/scripts/lipsync.mjsscript39.8 KB
references/craft/virtual-host/scripts/pinyin-table.mjsscript83.2 KB
references/craft/virtual-host/scripts/puppet-build.mjsscript48.6 KB
references/craft/virtual-host/scripts/puppet-mask.mjsscript3.0 KB
references/craft/virtual-host/scripts/puppet/align.mjsscript4.1 KB
references/craft/virtual-host/scripts/puppet/brows.mjsscript17.2 KB
references/craft/virtual-host/scripts/puppet/edits.mjsscript4.3 KB
references/craft/virtual-host/scripts/puppet/expression-labels.jsonconfig1.1 KB
references/craft/virtual-host/scripts/puppet/expreyes.mjsscript35.9 KB
references/craft/virtual-host/scripts/puppet/eyes.mjsscript8.6 KB
references/craft/virtual-host/scripts/puppet/fill.mjsscript10.5 KB
references/craft/virtual-host/scripts/puppet/layers.mjsscript5.7 KB
references/craft/virtual-host/scripts/puppet/mapbuild.mjsscript50.4 KB
references/craft/virtual-host/scripts/puppet/ops.mjsscript7.4 KB
references/craft/virtual-host/scripts/puppet/pack.mjsscript10.2 KB
references/craft/virtual-host/scripts/puppet/partmap.mjsscript8.5 KB
references/craft/virtual-host/scripts/puppet/parts.mjsscript7.0 KB
references/craft/virtual-host/scripts/puppet/png.mjsscript5.8 KB
references/craft/virtual-host/scripts/puppet/seg.mjsscript21.6 KB
references/craft/virtual-host/scripts/puppet/segment.mjsscript26.6 KB
references/craft/virtual-host/scripts/puppet/zip.mjsscript2.0 KB
references/craft/virtual-host/scripts/visemes.mjsscript21.4 KB
references/craft/vlog-from-clips.mdmarkdown13.2 KB
references/craft/vlog-from-clips/references/footage-log.mdmarkdown3.3 KB
references/mcp.mdmarkdown8.9 KB
references/start.mdmarkdown6.3 KB
references/workflows.mdmarkdown29.8 KB

references/mcp.md

View on GitHub
# 走 MCP:接法、工具名与差异

<!-- surface: agent -->
会话内不需要这一页:你用的工具就是 BaoCut 的工具目录。
<!-- /surface -->
<!-- surface: cli -->
BaoCut 的 MCP 服务与 CLI 是同一份工具目录。宿主里接好 MCP 之后,可以不开子进程、直接调工具;做法、craft 与硬规则都不变。CLI 能用时两条路任选其一,同一个任务里不要混着用。

## 1. 接上

一条命令接好(要用户同意,它会改宿主的 MCP 配置):

```text
baocut mcp install --agent <claude-code|codex|cursor|gemini> [--transport stdio|http] [--level ask|auto] [--name <客户端名>] [--yes]
```

它开启 MCP 服务(并设为随 BaoCut 的 Runtime 启动),在 BaoCut 里为这个宿主新建一个客户端,把接法与令牌写进宿主的 MCP 配置,然后提示重启宿主。默认写 stdio 形式:宿主拉起 `baocut mcp serve --stdio`,BaoCut 没开时它自己把 Runtime 拉起来;`--transport http` 改写地址,那样 BaoCut 得先开着。令牌的去向:Claude Code 放进它的环境变量段、配置里不写令牌;Codex、Cursor、Gemini CLI 明文写在配置文件里。问用户时把这一点说清楚。宿主配置里已有 `baocut` 条目时它不覆盖,要替换加 `--yes`(同样先问)。`baocut help mcp` 看这台机器上的版本支不支持;还不支持时用下面的手动接法。

手动接法(都是本机管理命令,逐条先问用户):

1. `baocut services start mcp` 开启 MCP 服务;`baocut services configure mcp --level ask` 设访问等级(`read` 只读;`ask` 写入与任务逐次由用户在 BaoCut 里确认,默认;`auto` 直接执行),`--videos` 限定开放的视频。
2. `baocut services mcp add-client <名字>` 为这个宿主建令牌(只显示一次,让用户自己保存)。
3. `baocut services mcp connection <clientId>` 打印地址与可以粘进宿主 MCP 配置的片段(令牌是占位符),请用户填好令牌、重启宿主。也可以写 stdio 形式:命令 `baocut mcp serve --stdio`,令牌放进那一项的环境变量 `BAOCUT_MCP_TOKEN`。

服务只监听本机回环地址;令牌一个宿主一个,可以单独吊销。

## 2. 工具名就是 `a_b`

MCP 工具 `<名词>_<动词>` 就是 CLI 的 `baocut <名词> <动词>`,参数同名(MCP 用字段名本身,`documentId`;CLI 是 `--document-id`)。一级动词两边同名。这份 skill 里写成 `baocut …` 的命令,在 MCP 上按这条规则换成工具名即可,错误里的 `next` 已经写成工具名。

工具名对照(由目录生成):

<!-- generated: tool-map -->
| MCP 工具 | CLI 命令 | 效果 |
| --- | --- | --- |
| `assets_analyze` | `baocut assets analyze` | query |
| `assets_dead_air` | `baocut assets dead-air` | query |
| `assets_download` | `baocut assets download` | mutation |
| `assets_import` | `baocut assets import` | mutation |
| `assets_prune` | `baocut assets prune` | mutation |
| `assets_search` | `baocut assets search` | query |
| `assets_sfx` | `baocut assets sfx` | mutation |
| `captions_create` | `baocut captions create` | mutation |
| `chapters_adopt` | `baocut chapters adopt` | mutation |
| `compositions_import` | `baocut compositions import` | mutation |
| `compositions_preview` | `baocut compositions preview` | mutation |
| `documents_put` | `baocut documents put` | mutation |
| `documents_read` | `baocut documents read` | query |
| `download` | `baocut download` | job |
| `dub` | `baocut dub` | job |
| `edits_apply` | `baocut edits apply` | mutation |
| `edits_ops` | `baocut edits ops` | query |
| `edits_undo` | `baocut edits undo` | mutation |
| `export` | `baocut export` | job |
| `image` | `baocut image` | job |
| `jobs_cancel` | `baocut jobs cancel` | mutation |
| `jobs_inspect` | `baocut jobs inspect` | query |
| `jobs_list` | `baocut jobs list` | query |
| `jobs_retry` | `baocut jobs retry` | job |
| `jobs_wait` | `baocut jobs wait` | query |
| `library_list` | `baocut library list` | query |
| `library_show` | `baocut library show` | query |
| `models_capabilities` | `baocut models capabilities` | query |
| `models_list` | `baocut models list` | query |
| `music` | `baocut music` | job |
| `projects_list` | `baocut projects list` | query |
| `skills_list` | `baocut skills list` | query |
| `skills_read` | `baocut skills read` | query |
| `space_list` | `baocut space list` | query |
| `space_search` | `baocut space search` | query |
| `speak` | `baocut speak` | job |
| `transcribe` | `baocut transcribe` | job |
| `translate` | `baocut translate` | job |
| `videos_create` | `baocut videos create` | mutation |
| `videos_derive` | `baocut videos derive` | mutation |
| `videos_frames` | `baocut videos frames` | mutation |
| `videos_history` | `baocut videos history` | query |
| `videos_inspect` | `baocut videos inspect` | query |
| `videos_list` | `baocut videos list` | query |
| `videos_restore_version` | `baocut videos restore-version` | mutation |
| `videos_save_version` | `baocut videos save-version` | mutation |
| `videos_shots` | `baocut videos shots` | query |
| `videos_version_diff` | `baocut videos version-diff` | query |
| `videos_versions` | `baocut videos versions` | query |

只在 CLI 里、MCP 上没有的:`baocut artifacts save`、`baocut assets process`、`baocut assets separate`、`baocut edits assemble`、`baocut hosts list`、`baocut hosts show`、`baocut models install`、`baocut models test`、`baocut projects create`、`baocut projects git-commit`、`baocut record`、`baocut recordings discard`、`baocut recordings list`、`baocut recordings pause`、`baocut recordings recover`、`baocut recordings resume`、`baocut recordings sources`、`baocut recordings status`、`baocut recordings stop`、`baocut retouch`、`baocut space index-build`、`baocut space index-status`、`baocut space related-videos`、`baocut space resolve-search-hit`、`baocut space search-v2`、`baocut speech glossary-candidates`、`baocut speech relevant`、`baocut speech retakes`、`baocut speech sentences`、`baocut speech topic-boundaries`、`baocut transcode`、`baocut upscale`、`baocut videos delete`、`baocut videos import-package`、`baocut videos match-frames`。
<!-- /generated -->

## 3. 等任务:`jobs_wait` 要循环

返回任务的工具(`transcribe`、`export`、`download`、`dub` 等)立即返回 `jobId`,不会等:

- 调 `jobs_wait { jobId }`:阻塞到终态或超时,`timeoutSec` 最多 50 秒(避开常见客户端 60 秒的请求超时)。
- `settled` 为 `false` 不是错误:照 `next` 再调一次 `jobs_wait`,直到 `state` 为终态。
- 不要用 `jobs_inspect` 反复轮询。

## 4. MCP 上没有的工具

这些只在 CLI 与 BaoCut 自己的会话里,MCP 服务不开放:

| 工具 | 改用 |
| --- | --- |
| `transcode` | CLI 的 `baocut transcode` |
| `videos_import_package` | CLI,或请用户在 BaoCut 里打开便携包 |
| `videos_delete` | 请用户在 BaoCut 里删除 |
| `projects_create` | CLI,或请用户在 BaoCut 里新建项目 |
| `projects_git_commit` | CLI 的 `baocut projects git-commit`,或请用户在 BaoCut 里提交 |
| `artifacts_save` | 产物要放进视频直接用 `assets_import` 给 `artifactId`;要文件用 `export` |
| `models_install`、`models_test` | CLI,或请用户在 BaoCut 的设置里装 |

管理命令(设置、服务、凭据、授权)一个都不在 MCP 上。

网页版编辑器也不在 MCP 上:要看合成后的画面、拖拽调整或请用户在编辑器里审,用 CLI 的 `baocut web open --video <videoId>`(见 [web](catalog/web.md))。

## 5. 与 CLI 的差异

| | CLI | MCP 服务 |
| --- | --- | --- |
| 身份 | 用户本人 | 一个外部客户端,受访问等级与视频范围约束 |
| 确认 | 宿主的权限提示负责;`destructive` 要 `--yes` | `ask` 等级下由用户在 BaoCut 里逐次确认,50 秒没确认就超时 |
| 路径 | 相对当前目录,用户的全部文件 | 相对视频所属项目;导出与产物只写进项目的 `exports/` |
| 新建视频 | 不给项目时从当前目录找 | `videos_create`、`download` 的 `newVideo` 都必须给 `project`(`projects_list` 取);建好的视频自动进你的范围 |
| 转写的输入 | 链接、本机文件或视频 | 视频,或链接加 `project`;不能给本机文件(`file`、`outDir`) |
| 下载的落点 | 不给时进下载目录 | 必须给 `video`(范围之内的)或 `project`;只给 `url` 被拒绝 |
| 长任务 | 默认等到完成 | `jobId` + `jobs_wait` 循环 |
| 大结果 | 写进 `.baocut-out/` | 字节预算与游标:照结果里的说明分段取 |
| 看得到的任务 | 全部 | 自己提交的 |

## 6. 被拒时

- 返回审批被拒或超时:用户没同意,不要换个说法重试,先问用户。
- 访问范围之外的视频对你不可见:请用户在 BaoCut 里把它加进范围,不要找别的路径去读。
- `read` 等级下写入与任务都会被拒:请用户调高等级,或改走 CLI。
<!-- /surface -->
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall