QCut Toolkit
Unified entry point for QCut's six sub-skills. Route tasks to the appropriate sub-skill based on what the user needs.
Sub-Skills
1. native-cli — Project Setup & Native Pipeline Commands
When: Setting up a project, cleaning up files, organizing workspace, importing media
Invoke: /native-cli
Skill path: .claude/skills/native-cli/SKILL.md
Handles:
- Initializing the standard project layout (
input/*, output/*, config/)
- Organizing media by extension with
organize-project
- Running structure audits with
structure-info
- Running editor media/timeline/export/diagnostic commands (
editor:*)
- Running additional native pipeline commands when needed
2. ffmpeg-skill — Media Processing
When: Converting, compressing, trimming, resizing, extracting audio, adding subtitles, creating GIFs, applying effects
Invoke: /ffmpeg-skill
Skill path: .claude/skills/qcut-toolkit/ffmpeg-skill/SKILL.md
Handles:
- Format conversion (MP4, MKV, WebM, MP3, etc.)
- Video compression (
-crf), resizing (scale=), trimming (-ss/-t)
- Audio extraction, subtitle burn-in, text overlays
- GIF creation, speed changes, merging/concatenation
- Streaming (HLS, DASH, RTMP) and complex filtergraphs
3. ai-content-pipeline — AI Content Generation & Analysis
When: Generating images/videos/avatars, transcribing audio, analyzing video, running AI pipelines
Invoke: /ai-content-pipeline
Skill path: .claude/skills/qcut-toolkit/ai-content-pipeline/SKILL.md
Handles:
- Text-to-image (FLUX, Imagen 4, Nano Banana Pro, GPT Image)
- Image-to-video (Veo 3, Sora 2, Kling, Hailuo)
- Avatar/lipsync generation (OmniHuman, Fabric, Multitalk)
- Speech-to-text transcription with word-level timestamps (Scribe v2)
- Video analysis with Gemini 3 Pro
- YAML pipeline orchestration with parallel execution
- Motion transfer between images and videos
4. seedance — Video Prompt Engineering
When: Writing video prompts, Seedance/即梦 workflows, AI video prompt generation, video descriptions (Chinese or English)
Invoke: /seedance
Skill path: .claude/skills/qcut-toolkit/seedance/SKILL.md
Handles:
- Seedance 2.0 (即梦) prompt generation in Chinese
- Multi-modal video prompts (text-to-video, image-to-video, video extension)
- Short drama (短剧), advertising video, and cinematic prompt templates
- Prompt engineering best practices for ByteDance video models
5. qcut-mcp-preview-test — MCP Preview Testing
When: Testing MCP app preview, toggling "MCP Media App" mode, debugging iframe rendering, troubleshooting mcp:app-html events or /api/claude/mcp/app
Invoke: /qcut-mcp-preview-test
Skill path: .claude/skills/qcut-toolkit/qcut-mcp-preview-test/SKILL.md
Handles:
- Switching preview panel between video preview and MCP app mode
- Validating iframe srcDoc rendering for MCP HTML content
- Debugging IPC (
mcp:app-html) and HTTP (/api/claude/mcp/app) delivery
- Crafting prompts that modify MCP media app UI safely
6. pr-comments — PR Review Processing
When: Exporting PR comments, evaluating code reviews, fixing review feedback from CodeRabbit/Gemini bots
Invoke: /pr-comments
Skill path: .claude/skills/pr-comments/SKILL.md
Handles:
- Export review comments from GitHub PRs to markdown files
- Preprocess comments into evaluation task files
- Analyze comment groupings by source file
- Evaluate, fix, or reject individual review comments
- Batch process all comments with bottom-up line ordering
- Resolve threads on GitHub and track completed tasks
Routing Logic
When the user's request involves multiple sub-skills, chain them in this order:
- Organize first — Ensure project structure exists before processing
- Process with FFmpeg — Convert, trim, or prepare source media
- Generate with AI — Create new content or analyze existing media
- Write prompts — Generate video prompts for Seedance/即梦 if needed
- Control editor — Use native-cli
editor:* commands to update timeline, settings, or import results
- Organize output — Place results in
media/generated/ or output/
Quick Routing Table
| User says |
Route to |
| "organize", "set up project", "clean up files" |
native-cli |
| "convert", "compress", "trim", "resize", "extract audio", "gif", "subtitle" |
ffmpeg-skill |
| "generate image", "generate video", "avatar", "lipsync", "transcribe", "analyze video", "AI pipeline" |
ai-content-pipeline |
| "add to timeline", "update project settings", "list media", "export preset", "configure for TikTok" |
native-cli |
| "import media", "get project stats", "diagnose error" |
native-cli |
| "video prompt", "Seedance", "即梦", "视频提示词", "write video description" |
seedance |
| "test MCP preview", "MCP app mode", "debug iframe", "mcp:app-html" |
qcut-mcp-preview-test |
| "export PR comments", "fix review feedback", "process code review" |
pr-comments |
| "process this video and generate thumbnails" |
ffmpeg-skill → ai-content-pipeline |
| "import media and organize" |
native-cli |
| "generate content and add to timeline" |
ai-content-pipeline → native-cli |
| "set up project then generate content" |
native-cli → ai-content-pipeline |
| "write prompt then generate video" |
seedance → ai-content-pipeline |
Multi-Step Workflow Example
User: "Take my raw footage, trim the first 30 seconds, compress it, then generate AI thumbnails"
/native-cli — Run init-project / organize-project to prepare the project structure and source media
/ffmpeg-skill — ffmpeg -ss 00:00:30 -i input.mp4 -c copy trimmed.mp4 then compress
/ai-content-pipeline — Extract a frame, generate styled thumbnail with flux_dev
- Place output in
input/, output/, or media/generated/ as needed
Output Structure
All sub-skills follow the same project structure:
Documents/QCut/Projects/{project-name}/
├── input/ ← native-cli init-project / organize-project
│ ├── images/
│ ├── videos/
│ ├── audio/
│ ├── text/
│ └── pipelines/
├── output/ ← final exports
│ ├── images/
│ ├── videos/
│ └── audio/
├── config/
└── media/generated/ ← ai-content-pipeline outputs (when used)
Full Production Workflow
$ARGUMENTS
Break the request into steps, invoke each sub-skill in sequence, and report progress after each step. Always confirm destructive operations (overwriting files, deleting temp data) before executing.
1---2name: qcut-toolkit3description: "Unified QCut media toolkit — organize project files, process media with FFmpeg, generate AI content, control the QCut editor with native CLI commands, generate video prompts, and test MCP preview. Use when the user asks about any media workflow, file organization, video processing, AI generation, editor control, video prompts, or content pipeline task."4metadata:5 source: https://skillmd.com/skills/dvcrn/qcut-toolkit6---78# QCut Toolkit910Unified entry point for QCut's six sub-skills. Route tasks to the appropriate sub-skill based on what the user needs.1112## Sub-Skills1314### 1. native-cli — Project Setup & Native Pipeline Commands15**When:** Setting up a project, cleaning up files, organizing workspace, importing media16**Invoke:** `/native-cli`17**Skill path:** `.claude/skills/native-cli/SKILL.md`1819Handles:20- Initializing the standard project layout (`input/*`, `output/*`, `config/`)21- Organizing media by extension with `organize-project`22- Running structure audits with `structure-info`23- Running editor media/timeline/export/diagnostic commands (`editor:*`)24- Running additional native pipeline commands when needed2526### 2. ffmpeg-skill — Media Processing27**When:** Converting, compressing, trimming, resizing, extracting audio, adding subtitles, creating GIFs, applying effects28**Invoke:** `/ffmpeg-skill`29**Skill path:** `.claude/skills/qcut-toolkit/ffmpeg-skill/SKILL.md`3031Handles:32- Format conversion (MP4, MKV, WebM, MP3, etc.)33- Video compression (`-crf`), resizing (`scale=`), trimming (`-ss`/`-t`)34- Audio extraction, subtitle burn-in, text overlays35- GIF creation, speed changes, merging/concatenation36- Streaming (HLS, DASH, RTMP) and complex filtergraphs3738### 3. ai-content-pipeline — AI Content Generation & Analysis39**When:** Generating images/videos/avatars, transcribing audio, analyzing video, running AI pipelines40**Invoke:** `/ai-content-pipeline`41**Skill path:** `.claude/skills/qcut-toolkit/ai-content-pipeline/SKILL.md`4243Handles:44- Text-to-image (FLUX, Imagen 4, Nano Banana Pro, GPT Image)45- Image-to-video (Veo 3, Sora 2, Kling, Hailuo)46- Avatar/lipsync generation (OmniHuman, Fabric, Multitalk)47- Speech-to-text transcription with word-level timestamps (Scribe v2)48- Video analysis with Gemini 3 Pro49- YAML pipeline orchestration with parallel execution50- Motion transfer between images and videos5152### 4. seedance — Video Prompt Engineering53**When:** Writing video prompts, Seedance/即梦 workflows, AI video prompt generation, video descriptions (Chinese or English)54**Invoke:** `/seedance`55**Skill path:** `.claude/skills/qcut-toolkit/seedance/SKILL.md`5657Handles:58- Seedance 2.0 (即梦) prompt generation in Chinese59- Multi-modal video prompts (text-to-video, image-to-video, video extension)60- Short drama (短剧), advertising video, and cinematic prompt templates61- Prompt engineering best practices for ByteDance video models6263### 5. qcut-mcp-preview-test — MCP Preview Testing64**When:** Testing MCP app preview, toggling "MCP Media App" mode, debugging iframe rendering, troubleshooting `mcp:app-html` events or `/api/claude/mcp/app`65**Invoke:** `/qcut-mcp-preview-test`66**Skill path:** `.claude/skills/qcut-toolkit/qcut-mcp-preview-test/SKILL.md`6768Handles:69- Switching preview panel between video preview and MCP app mode70- Validating iframe srcDoc rendering for MCP HTML content71- Debugging IPC (`mcp:app-html`) and HTTP (`/api/claude/mcp/app`) delivery72- Crafting prompts that modify MCP media app UI safely7374### 6. pr-comments — PR Review Processing75**When:** Exporting PR comments, evaluating code reviews, fixing review feedback from CodeRabbit/Gemini bots76**Invoke:** `/pr-comments`77**Skill path:** `.claude/skills/pr-comments/SKILL.md`7879Handles:80- Export review comments from GitHub PRs to markdown files81- Preprocess comments into evaluation task files82- Analyze comment groupings by source file83- Evaluate, fix, or reject individual review comments84- Batch process all comments with bottom-up line ordering85- Resolve threads on GitHub and track completed tasks8687## Routing Logic8889When the user's request involves multiple sub-skills, chain them in this order:90911. **Organize first** — Ensure project structure exists before processing922. **Process with FFmpeg** — Convert, trim, or prepare source media933. **Generate with AI** — Create new content or analyze existing media944. **Write prompts** — Generate video prompts for Seedance/即梦 if needed955. **Control editor** — Use native-cli `editor:*` commands to update timeline, settings, or import results966. **Organize output** — Place results in `media/generated/` or `output/`9798### Quick Routing Table99100| User says | Route to |101|-----------|----------|102| "organize", "set up project", "clean up files" | native-cli |103| "convert", "compress", "trim", "resize", "extract audio", "gif", "subtitle" | ffmpeg-skill |104| "generate image", "generate video", "avatar", "lipsync", "transcribe", "analyze video", "AI pipeline" | ai-content-pipeline |105| "add to timeline", "update project settings", "list media", "export preset", "configure for TikTok" | native-cli |106| "import media", "get project stats", "diagnose error" | native-cli |107| "video prompt", "Seedance", "即梦", "视频提示词", "write video description" | seedance |108| "test MCP preview", "MCP app mode", "debug iframe", "mcp:app-html" | qcut-mcp-preview-test |109| "export PR comments", "fix review feedback", "process code review" | pr-comments |110| "process this video and generate thumbnails" | ffmpeg-skill → ai-content-pipeline |111| "import media and organize" | native-cli |112| "generate content and add to timeline" | ai-content-pipeline → native-cli |113| "set up project then generate content" | native-cli → ai-content-pipeline |114| "write prompt then generate video" | seedance → ai-content-pipeline |115116### Multi-Step Workflow Example117118User: "Take my raw footage, trim the first 30 seconds, compress it, then generate AI thumbnails"1191201. `/native-cli` — Run `init-project` / `organize-project` to prepare the project structure and source media1212. `/ffmpeg-skill` — `ffmpeg -ss 00:00:30 -i input.mp4 -c copy trimmed.mp4` then compress1223. `/ai-content-pipeline` — Extract a frame, generate styled thumbnail with `flux_dev`1234. Place output in `input/`, `output/`, or `media/generated/` as needed124125## Output Structure126127All sub-skills follow the same project structure:128129```130Documents/QCut/Projects/{project-name}/131├── input/ ← native-cli init-project / organize-project132│ ├── images/133│ ├── videos/134│ ├── audio/135│ ├── text/136│ └── pipelines/137├── output/ ← final exports138│ ├── images/139│ ├── videos/140│ └── audio/141├── config/142└── media/generated/ ← ai-content-pipeline outputs (when used)143```144145## Full Production Workflow146147```148$ARGUMENTS149```150151Break the request into steps, invoke each sub-skill in sequence, and report progress after each step. Always confirm destructive operations (overwriting files, deleting temp data) before executing.