# Bggg Tiktok Capcut

通用 CapCut 草稿生成与 AI 视频检查 skill。用于把本地 AI 视频套用现有 CapCut 草稿模板， 生成可在 CapCut...

- Repository: https://github.com/binggandata/bggg-skills (612 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-08-13
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add binggandata/bggg-skills --skill bggg-tiktok-capcut -g -a claude-code -y`
Codex: `npx skills add binggandata/bggg-skills --skill bggg-tiktok-capcut -g -a codex -y`
Cursor: `npx skills add binggandata/bggg-skills --skill bggg-tiktok-capcut -g -a cursor -y`
Gemini CLI: `npx skills add binggandata/bggg-skills --skill bggg-tiktok-capcut -g -a gemini-cli -y`

## Description

通用 CapCut 草稿生成与 AI 视频检查 skill。用于把本地 AI 视频套用现有 CapCut 草稿模板， 生成可在 CapCut 首页显示并可编辑的新草稿；也用于提取模板样式、验证草稿结构、抽帧检查 AI 痕迹、规划修复窗口和做本地 RIFE 补帧。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# BGGG TikTok CapCut

这个 skill 只保留通用能力：

- 基于现有 CapCut 草稿模板生成新草稿
- 提取模板里的字幕样式、转场、动画、特效
- 验证草稿是否会被 CapCut 索引并显示
- 对 AI 视频或 CapCut 草稿抽帧做 AI 痕迹检查
- 为明显 AI 痕迹生成修复窗口
- 用本地 RIFE 做高质量补帧预处理

默认 CapCut 草稿根目录：

```bash
$HOME/Movies/CapCut/User Data/Projects/com.lveditor.draft
```

如果你的 CapCut 草稿目录不同，设置 `CAPCUT_DRAFT_ROOT` 或给脚本传 `--output-dir` / `--draft-root`。

## 生成草稿

```bash
node <skill-dir>/scripts/create-capcut-draft.mjs \
  --template "PL-magicrep-PV-001" \
  --video "/path/to/ai-video.mp4" \
  --name "ai-video-capcut-001" \
  --captions "Line 1\nLine 2\nLine 3" \
  --split-at 7.5
```

常用参数：

| 参数 | 说明 |
| --- | --- |
| `--template` | 已存在的 CapCut 草稿目录名 |
| `--video` | 本地 AI 视频路径 |
| `--name` | 新草稿目录名和首页显示名 |
| `--captions` | 字幕文本，可用 `\n` 分行 |
| `--srt` | SRT 字幕文件，替代 `--captions` |
| `--split-at` | 视频切分点，转场会挂在切点前一段 |
| `--no-transition` | 不复制模板转场 |
| `--no-captions` | 不生成字幕轨道 |
| `--output-dir` | 自定义 CapCut 草稿根目录 |
| `--force` | 同名草稿已存在时先替换 |

脚本会同步这些 CapCut 会读取的文件，避免草稿目录存在但首页不显示：

- `draft_info.json`
- `draft_meta_info.json`
- `draft_info.json.bak`
- `template-2.tmp`
- `Timelines/project.json`
- `Timelines/<draft_info.id>/draft_info.json`
- `Timelines/<draft_info.id>/template.tmp`
- `Timelines/<draft_info.id>/template-2.tmp`
- `root_meta_info.json`

生成后如果 CapCut 已打开，完全退出再打开，让首页重新加载 `root_meta_info.json`。

## 验证草稿

```bash
node <skill-dir>/scripts/validate-capcut-draft.mjs \
  --draft "ai-video-capcut-001" \
  --stale-marker "OLD_TEMPLATE_NAME"
```

验证点包括：

- root 索引是否有对应条目
- `draft_info.id` 与 `Timelines/<id>`、`project.json` 是否一致
- 顶层和嵌套 `draft_info/template` 副本是否同步
- 视频素材路径是否存在
- 是否有旧模板名或旧素材路径残留

## 提取模板样式

```bash
node <skill-dir>/scripts/extract-template-styles.mjs \
  --template "PL-magicrep-PV-001" \
  --output ./capcut-template-styles.json
```

输出包含字幕样式、转场、动画、特效、画布和轨道结构。

## AI 痕迹检查

对单个视频抽帧：

```bash
node <skill-dir>/scripts/extract-ai-artifact-frames.mjs \
  --video "/path/to/ai-video.mp4" \
  --output-root ./ai-artifact-qa
```

对 CapCut 草稿时间线抽帧：

The rest: https://github.com/binggandata/bggg-skills/blob/HEAD/bggg-tiktok-capcut/SKILL.md