Agent skill

CapCut Video Director

by sun-guannan in sun-guannan/VectCutAPI

Guides an agent in building and polishing CapCut Desktop video projects through the CapCut MCP server and direct timeline file edits, including vertical canvas, subtitles and audio.

Apache-2.0Auto-check passedMedia & Creative

Install CapCut Video Director

skills CLI
$ npx skills add sun-guannan/VectCutAPI --skill capcut-director -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sun-guannan/VectCutAPI capcut-director --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sun-guannan/VectCutAPI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/capcut-director .claude/skills/capcut-director && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
capcut-director
GitHub stars
2.3k
Token cost
~1.7k tokens
SKILL.md length
639 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

Guides an agent in building and polishing CapCut Desktop video projects through the CapCut MCP server and direct timeline file edits, including vertical canvas, subtitles and audio.

  • Works in 7 steps: CapCut Desktop Architecture & File System → In-Memory Process Lifecycle & The… → Canvas & Aspect Ratio Configuration → …
  • Building a vertical 9:16 video project in CapCut programmatically
  • SKILL.md covers 1. CapCut Desktop Architecture…, 2. In-Memory Process Lifecycle…, 3. Canvas & Aspect Ratio… and 4. Professional Typography &…, plus 3 more sections
  • Calls ffmpeg

What it does

This skill explains how CapCut Desktop stores projects and how to edit them without losing work. Project folders on Windows and macOS hold a root draft_content.json plus, in CapCut 9.x and later, a Timelines folder per timeline. The app reads the timeline copy, so writing only the root file opens an empty timeline, and both have to be written.

Because CapCut loads a project into memory and has no file watcher, its autosave overwrites outside edits. The skill says to close CapCut before modifying draft files and to reopen from the home screen afterwards, as part of a .locked rule for the process lifecycle. A vertical project such as 1080x1920 needs explicit canvas_config settings, or the preview falls back to widescreen. Further sections cover mobile subtitle and typography sizing, audio mastering and companion rendering.

When your agent uses it

  • Building a vertical 9:16 video project in CapCut programmatically
  • Editing a CapCut draft's timeline files without CapCut overwriting them
  • Setting up readable subtitles and typography for mobile viewing

Example prompts

  • “Create a vertical CapCut project with three clips, captions and background music through the CapCut MCP.”
  • “My edited draft_content.json opens as an empty timeline in CapCut; fix it.”
  • “Set up subtitles sized for a phone screen in my existing CapCut project.”

Requirements

  • CapCut Desktop
  • The CapCut MCP server

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. CapCut Desktop Architecture & File System
  2. In-Memory Process Lifecycle & The '.locked' Rule
  3. Canvas & Aspect Ratio Configuration
  4. Professional Typography & Subtitle Standards
  5. Audio Mastering & Sidechain Ducking
  6. End-to-End Execution Workflow
  7. Live Editing Reflection: Web Preview & Desktop Hot-Reload

What it can do on your machine

Read from SKILL.md and the folder at commit cfa4779. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • ffmpeg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

CapCut Video Director loads about 1.7k tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 639 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sun-guannan/VectCutAPI at commit cfa4779, republished under its Apache-2.0 licence (© sun-guannan). 639 words, ~1,731 tokens.

Download SKILL.mdSave it as .claude/skills/capcut-director/SKILL.md (or your agent's skills folder).
name
capcut-director
description
Expert skill for programmatically creating, editing, styling, and rendering cinematic video projects via CapCut MCP and direct timeline engineering. Covers multi-timeline CapCut 9.x+ architecture, 9:16 vertical canvas configuration, professional typography/subtitling, audio mastering, process locking, and companion rendering.

CapCut Video Director & Timeline Engineering Skill

This skill guides AI agents in programmatically directing, assembling, and polishing video projects using the CapCut MCP server and direct CapCut Desktop timeline engineering.


1. CapCut Desktop Architecture & File System

Project Locations
  • Windows: C:\Users\<Username>\AppData\Local\CapCut\User Data\Projects\com.lveditor.draft\<ProjectName>
  • macOS: ~/Library/Containers/com.lemon.lvpro/Data/Documents/JianyingPro/User Data/Projects/com.lveditor.draft/<ProjectName>
The Multi-Timeline Architecture (CapCut 9.x+)

Modern CapCut Desktop (v9.0+) uses a nested multi-timeline system:

com.lveditor.draft/<ProjectName>/
├── draft_content.json             <-- Root compatibility state
├── draft_meta_info.json           <-- Project name, thumbnail, edit time
├── draft_cover.jpg                <-- Cover thumbnail
├── .locked                        <-- Lock file present while project is open in CapCut
└── Timelines/
    └── <TIMELINE-UUID>/
        ├── draft_content.json     <-- ACTIVE TIMELINE STATE (Read by CapCut 9.x+!)
        ├── draft_content.json.bak <-- Autosave backup
        └── template.tmp           <-- Working buffer

[!IMPORTANT] CapCut 9.x+ reads Timelines/<UUID>/draft_content.json, NOT the root file alone! If you only write to the root draft_content.json (as standard legacy MCP libraries do), CapCut will open an empty timeline. Always write to both the root and the active timeline directory.


2. In-Memory Process Lifecycle & The '.locked' Rule

CapCut Desktop loads project files into C++ RAM upon opening and does not feature a live file watcher.

  1. Avoid Overwrites: While CapCut is open, its background autosave thread will overwrite any external disk changes with its in-memory state.
  2. Workflow for External Updates:
    powershell
    # 1. Close CapCut before modifying draft files
    Get-Process -Name 'CapCut' -ErrorAction SilentlyContinue | Stop-Process -Force
    Start-Sleep -Seconds 1
    
    # 2. Write updated draft_content.json
    # ... (write files)
    
    # 3. Remove stale lock files
    Get-ChildItem -Path "$env:LOCALAPPDATA\CapCut\User Data\Projects\com.lveditor.draft" -Recurse -Filter '.locked' | Remove-Item -Force
  3. Reopening: Users must return to the CapCut Home screen or relaunch CapCut to reload the updated project from disk.

3. Canvas & Aspect Ratio Configuration

When creating a vertical project (e.g. 1080x1920 9:16), CapCut requires explicit canvas_config settings in draft_content.json. Otherwise, the preview player defaults to widescreen [16:9]:

json
{
  "canvas_config": {
    "height": 1920,
    "width": 1080,
    "ratio": "9:16"
  }
}

4. Professional Typography & Subtitle Standards

Mobile (9:16) Sizing Guidelines

Text must be legible on small mobile viewports. Avoid small desktop font defaults:

Text TypeFont Size (FFmpeg / pt)CapCut Size ValuePurpose
Main Title / Hero Hook80pt – 135pt9.0 – 12.0Strong focal impact, title cards
Secondary Sub-headline68pt – 85pt8.0 – 9.5Key concepts, etymology breakdown
Subtitles / Explanations56pt – 64pt6.5 – 7.5Minimum size for effortless mobile reading
Micro Labels / Badges42pt – 48pt5.0 – 5.5Metadata, subtle tags only
Line Spacing & Vertical Breathing Room
  • Default CapCut line spacing (0.05) is too cramped for multi-line titles, causing text lines to collide.
  • Always set "line_spacing": 0.25 to 0.32 for multi-line text blocks.
  • Separate distinct text layers by at least 115px – 140px vertically in 1080x1920 space.
Contrast & Legibility Over Dynamic Footage

Never render plain text over variable video backgrounds:

  1. Multi-layer Drop Shadows:
    • Primary shadow: angle: -45.0, distance: 4.0 - 6.0, alpha: 0.95, diffuse: 0.08
  2. Backdrop Box / Gradient Plate:
    • Semi-transparent dark backplate: box=1:boxcolor=black@0.35:boxborderw=16
  3. Safe Zones:
    • Avoid placing subtitles at y < 15% (header UI/notch) or y > 85% (caption/bottom bar UI).
    • Ideal lower-third subtitle placement: y = 75% - 80%.
    • Upper-third placement (for scenes with bottom subjects): y = 20% - 25%.

Show full SKILL.md (248 more words)Show less

5. Audio Mastering & Sidechain Ducking

Cinematic videos require layered sound design:

Timeline:
Track 1: Ambient / Cinematic Music (-13 dB during speech, -5.5 dB in pauses)
Track 2: Voiceover (Loudness normalized, +1.25 volume, 80Hz high-pass filter)
Track 3: SFX Accents (Chimes, whooshes, risers, time-aligned to visual cuts)
  • Apply dynamic sidechain ducking (-7.5 dB to -10 dB reduction) on background music whenever the voiceover track is active.
  • Ensure audio ends with a 0.8s – 1.2s smooth fade-out.

6. End-to-End Execution Workflow

  1. Initialize Project: Create the draft and import curated media via CapCut MCP or direct Python script.
  2. Inject Multi-Timeline Structure: Write Timelines/<UUID>/draft_content.json with 9:16 canvas, scaled typography, and generous line spacing.
  3. Master Render: Render an exact 30fps H.264 master video with normalized SAR (setsar=1) and AAC audio for instant preview.
  4. Inspect Keyframes: Extract single-frame JPGs across all scene boundaries (ffmpeg -ss ... -vframes 1) to verify text centering and legibility before delivering.

7. Live Editing Reflection: Web Preview & Desktop Hot-Reload

To eliminate manual reopening and delays, use the dual live-editing system:

1. Web Live-Preview Player (0ms Feedback)
  • URL: http://127.0.0.1:9001/preview
  • Real-time HTML5 9:16 canvas player with interactive multi-track timeline scrubber.
  • Server-Sent Events (SSE): Automatically wakes up and reflects edits made via MCP or API without browser refresh.
  • Live Element Inspector: Allows instant in-browser tweaking of text strings, font sizes, colors, and coordinates with the "Apply Live Changes" button.
  • Direct Actions:
    • ⚡ Sync to CapCut: Saves and deploys draft directly to CapCut Desktop.
    • 🔄 Reload Desktop: Triggers automated CapCut desktop hot-reload.
2. Desktop Auto-Reload Companion
  • MCP Tool: capcut_reload_desktop(project_name=...)
  • Auto-Reload on Save: Pass auto_reload: true to capcut_save_draft to automatically refresh CapCut Desktop immediately after saving.
  • Automates project cycling (Home -> Reopen) in under 1 second without manual mouse intervention.

© sun-guannan, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/capcut-director of sun-guannan/VectCutAPI.

Open the folder on GitHubat commit cfa4779

Compare with similar skills

CapCut Video Director next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

CapCut Video Director compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
CapCut Video Director this skillsun-guannan/VectCutAPI2.3k—~1.7kAutomated safety check: PassApache-2.0
OpenStoryline Install HelperFireRedTeam/FireRed-OpenStoryline3.5k—~1.5kAutomated safety check: NotesApache-2.0
Cassette Video EditCassette-Editor/oh-my-cassette1581 repos~3.4kAutomated safety check: PassMIT
Bang Motionbangtutorial/bang-motion584—~9.7kAutomated safety check: PassMIT
ShowtimeFavioVazquez/showtime206—~3kAutomated safety check: PassMIT
KinocutKyaniteLabs/kinocut197—~5.7kAutomated safety check: PassApache-2.0

Similar skills

  • OpenStoryline Install Helper

    FireRedTeam/FireRed-OpenStoryline

    Installs, repairs and starts a local source checkout of FireRed-OpenStoryline, from prerequisites and a venv to resources, config and the MCP and web servers.

    3.5k GitHub stars~1.5k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Cassette Video Edit

    Cassette-Editor/oh-my-cassette

    Edit, trim, cut, caption, subtitle, reframe, combine, add background music to, or export video, audio, and image files through Cassette.

    158 GitHub starsUsed in 1 repo~3.4k tokens
    Media & CreativeAuto-check passed
  • Bang Motion

    bangtutorial/bang-motion

    Membangun motion graphic sinematik di browser (promo video, opener, intro, bumper, kinetic typography, explainer/video penjelasan bergambar 16:9 atau 9:16) memakai HTML + CSS + GSAP (+ Three.js bila…

    584 GitHub stars~9.7k tokensUpdated 24 days ago
    Media & CreativeAuto-check passed
  • Showtime

    FavioVazquez/showtime

    A skill your agent uses when the user wants a video made, edited or finished: a launch or promo, product demo, explainer, trailer or teaser, tutorial or walkthrough, a screen recording turned into a…

    206 GitHub stars~3k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Kinocut

    KyaniteLabs/kinocut

    Use Kinocut for guarded video editing, source-backed planning, FFmpeg operations, media analysis, subtitles, audio workflows, Hyperframes or Revideo rendering, repurposing packages, and release…

    197 GitHub stars~5.7k tokensUpdated today
    Media & CreativeAuto-check passed
  • Kinocut Repurpose

    KyaniteLabs/kinocut

    Use the current Kinocut tools to turn one local video path into a short platform-ready clip package with manifests, review artifacts, and human approval gates.

    197 GitHub stars~1k tokensUpdated today
    Media & CreativeAuto-check passed

More from sun-guannan/VectCutAPI

  • VectCutAPI Video Editing

    sun-guannan/VectCutAPI

    Drives CapCut or JianYing through an HTTP and MCP API: create drafts, add video, audio, text, subtitles and effects, preview on the web and batch-produce videos.

    2.3k GitHub stars~2.1k tokensUpdated 6 days ago
    Auto-check passed

Questions about CapCut Video Director

What does CapCut Video Director do?

Guides an agent in building and polishing CapCut Desktop video projects through the CapCut MCP server and direct timeline file edits, including vertical canvas, subtitles and audio. This skill explains how CapCut Desktop stores projects and how to edit them without losing work.x and later, a Timelines folder per timeline.

When should I use CapCut Video Director?

CapCut Video Director fits situations like: building a vertical 9:16 video project in CapCut programmatically; editing a CapCut draft's timeline files without CapCut overwriting them; setting up readable subtitles and typography for mobile viewing.

How do I install CapCut Video Director in Claude Code?

Run `npx skills add sun-guannan/VectCutAPI --skill capcut-director -a claude-code`. Or copy the skill folder (.agents/skills/capcut-director in sun-guannan/VectCutAPI) into .claude/skills/capcut-director in your project. Claude Code loads it when a task matches its description.

How do I install CapCut Video Director in Codex?

Run `npx skills add sun-guannan/VectCutAPI --skill capcut-director -a codex`. Or copy the skill folder (.agents/skills/capcut-director in sun-guannan/VectCutAPI) into .agents/skills/capcut-director in your project. Codex loads it when a task matches its description.

Can I use CapCut Video Director in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sun-guannan/VectCutAPI --skill capcut-director -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/capcut-director, .gemini/skills/capcut-director, .github/skills/capcut-director and .opencode/skills/capcut-director in your project.

What does CapCut Video Director need to run?

Going by SKILL.md and its folder, CapCut Video Director needs the command-line tools its instructions call (ffmpeg). Our summary lists: CapCut Desktop; The CapCut MCP server.

Does CapCut Video Director access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is CapCut Video Director safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does CapCut Video Director use?

CapCut Video Director is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does CapCut Video Director use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to CapCut Video Director?

Skills that share tags, products or a category with CapCut Video Director: OpenStoryline Install Helper (FireRedTeam/FireRed-OpenStoryline, 3.5k stars), Cassette Video Edit (Cassette-Editor/oh-my-cassette, 158 stars), Bang Motion (bangtutorial/bang-motion, 584 stars) and Showtime (FavioVazquez/showtime, 206 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains CapCut Video Director?

sun-guannan (a GitHub user) maintains it in sun-guannan/VectCutAPI, which has 2,287 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 3, 2026.

Source: sun-guannan/VectCutAPI on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.