Agent skill

Capcut Edit

by renezander030 in renezander030/capcut-cli

Edit CapCut / JianYing video projects — read and write subtitles, timing, speed, volume, templates, animations (fade/ken-burns), and cut long-form to shorts.

MITAuto-check passedMedia & Creative

Install Capcut Edit

skills CLI
$ npx skills add renezander030/capcut-cli --skill capcut-edit -a claude-code

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

GitHub CLI
$ gh skill install renezander030/capcut-cli capcut-edit --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/renezander030/capcut-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/capcut-edit .claude/skills/capcut-edit && 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-edit
GitHub stars
832
Token cost
~1.4k tokens
SKILL.md length
548 words
Files
14 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Edit CapCut / JianYing video projects — read and write subtitles, timing, speed, volume, templates, animations (fade/ken-burns), and cut long-form to shorts.

  • The user mentions capcut
  • SKILL.md covers Project locations, Core principle — deterministic…, Progressive disclosure and Output modes, plus 4 more sections
  • Runs Shell scripts from its folder; calls python3
  • Draftcontent.json

What it does

Capcut Edit is an agent skill from renezander030/capcut-cli. Edit CapCut / JianYing video projects — read and write subtitles, timing, speed, volume, templates, animations (fade/ken-burns), and cut long-form to shorts. Use when the user mentions capcut, jianying, subtitles, video editing, draftcontent.json, draftinfo.json, or cutting videos — in English or Chinese (剪映, 字幕, 草稿, 剪辑, 切片, 视频编辑).

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 17 other files, including scripts, reference files and assets (for example `assets/animations.json`, `assets/examples/subscribe-cta.json` and `references/api-reference.md`).

It sits in Media & Creative, covering Transcription, Video production and Content repurposing. It works with Python. The repository describes itself as: Independent, unofficial CLI to edit CapCut and JianYing (剪映) projects — subtitles, timing, speed, volume, templates, cut long-form to shorts. No API needed, reads… The licence is MIT.

When your agent uses it

  • The user mentions capcut
  • Draftcontent.json
  • Cutting videos — in English

Example prompts

  • “/capcut-edit”

Requirements

  • Python 3
  • A Bash shell

What it can do on your machine

Read from SKILL.md and the folder at commit cb348ed. 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

    Ships 7 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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 Edit loads about 1.4k tokens when it runs, and up to ~10k if it reads all its reference files. Until then it costs about 87 tokens; SKILL.md has 548 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~10k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from renezander030/capcut-cli at commit cb348ed, republished under its MIT licence (© renezander030). 548 words, ~1,404 tokens.

Download SKILL.mdSave it as .claude/skills/capcut-edit/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.
name
capcut-edit
description
Edit CapCut / JianYing video projects — read and write subtitles, timing, speed, volume, templates, animations (fade/ken-burns), and cut long-form to shorts. Use when the user mentions capcut, jianying, subtitles, video editing, draft_content.json, draft_info.json, or cutting videos — in English or Chinese (剪映, 字幕, 草稿, 剪辑, 切片, 视频编辑).

capcut-edit

CLI for editing CapCut / JianYing drafts through a version-aware store. v0.11 detects and synchronizes readable timelines across draft_content.json, draft_info.json, draft_meta_info.json, and template-2.tmp.

Project locations

  • macOS: ~/Movies/CapCut/User Data/Projects/com.lveditor.draft/<project>/
  • Windows: %LOCALAPPDATA%\CapCut\User Data\Projects\com.lveditor.draft\<project>\

Core principle — deterministic scripts

Any recipe involving more than one capcut call, any arithmetic, or any branching ships as a parameterised shell script in scripts/. Claude invokes the script with inputs; the script runs a fixed sequence. If a recipe can be a script, it must be a script — not a narrative in references/.

references/workflows.md documents which script to call and why, never a reconstructable sequence.

Progressive disclosure

Start broad, drill into what you need. Never dump full project JSON.

bash
capcut info <project> -H           # overview
capcut doctor -H                   # installed media/transcription capabilities
capcut diagnose <project> -H       # canonical files, divergence, editor safety
capcut tracks <project> -H         # all tracks
capcut materials <project> -H      # material summary
capcut segments <project> -H       # segments with timing
capcut segment <project> <id>      # one item, full detail

Output modes

  • JSON (default): pipe to jq, feed to scripts.
  • -H: human-readable tables.
  • -q: quiet, exit code only — for write commands in scripts.

Batch writes

bash
echo '{"cmd":"set-text","id":"a1b2c3","text":"Fixed"}
{"cmd":"volume","id":"d4e5f6","volume":0.5}' | capcut batch <project>

Operations: set-text, shift, shift-all, speed, volume, opacity, trim.

Batch is transactional: one failing operation writes nothing. Use --continue-on-error only when the user explicitly accepts a partial commit; it still exits non-zero.

Where to look

  • references/api-reference.md — every command, every flag, every value format (time, percentages, degrees), the ID-prefix rule, the .bak invariant.
  • ../../docs/command-reference.md — generated command-contract v2 with typed positionals/options, mutability, prerequisites, output form, and exit codes.
  • references/workflows.md — recipes = which scripts/X.sh to run and why.
  • references/pitfalls.md — close-project-first, .bak, clip=null on audio, source_timerange math with speed, alpha-keyframes-don't-render-use-animation-materials, etc.
  • Enum discovery — call capcut enums --<category> (or -H for a table) to list every CapCut slug. Categories: --transitions, --masks, --image-intros, --image-outros, --image-combos, --text-intros, --text-outros, --text-loop-anims, --scene-effects, --character-effects, --audio-effects, --fonts. Add --jianying to switch namespace. The enums.json bundle is generated once via python3 scripts/extract-enums.py; runtime is Python-free.
  • scripts/ — the client library. Current:
    • anim.sh — attach any of 9 CapCut intro/outro animations; fade-in.sh and fade-out.sh are thin wrappers.
    • ken-burns.sh — scale + pan keyframes via capcut keyframe --batch (motion properties render; alpha does not — use anim.sh fade-in instead).
    • long-to-short.sh — cut a range, stamp title + CTA text.
    • stamp-cta.sh — apply a saved text template (see assets/examples/subscribe-cta.json).
    • _test.sh — run every wrapper against the fixture; run after any change here.
  • assets/examples/ — raw JSON snippets for hand-editing.
Show full SKILL.md (210 more words)Show less

Invariants

  • Close the project in CapCut before editing; reopen after.
  • Every write is conflict-checked, prepared atomically, and synchronized to every readable timeline target. Every target receives .bak and rolling history snapshots.
  • Never pass --force-write unless the user explicitly accepts overwriting changed-on-disk state or an open editor.
  • clip is null on audio segments (no opacity/scale).
  • capcut cut writes to --out, never modifies the source.
  • IDs: first 6+ chars of the UUID match as a prefix.
  • Time formats: 1.5s, 500ms, +0.5s, -1s, 1:30, 0:05.5, bare number = seconds.

v0.11 high-value paths

  • Whole draft: capcut compile spec.json --check, then capcut compile spec.json --out <dir>. Specs support refs, transforms, decorators, templates, captions, keyframes, and fades.
  • Karaoke: capcut caption <project> --audio <path> --whisper-engine <openai|whisper-cpp|faster-whisper> --karaoke.
  • Proxy: capcut render <project> --all-video-tracks --burn-captions; run doctor first for FFmpeg capability flags.
  • Automation: capcut serve --workers N --retries N --timeout MS; give jobs stable id fields and let the runner serialize writes per project.
  • Agent schema: on CLI v0.28.0 or newer, start with capcut describe --compact to discover commands, then fetch complete contracts with capcut describe --command <name> (repeat for several names). Plain capcut describe returns the full registry and works on older versions. Use these contracts as the source of truth; do not scrape help text or invent flags.

© renezander030, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 13 other files (scripts, references, assets) in skills/capcut-edit of renezander030/capcut-cli.

  • SKILL.md
  • assets/animations.json
  • assets/examples/ken-burns.jsonl
  • assets/examples/subscribe-cta.json
  • references/api-reference.md
  • references/pitfalls.md
  • references/workflows.md
  • scripts/_test.sh
  • scripts/anim.sh
  • scripts/fade-in.sh
  • scripts/fade-out.sh
  • scripts/ken-burns.sh
  • scripts/long-to-short.sh
  • scripts/stamp-cta.sh

Open the folder on GitHubat commit cb348ed

Compare with similar skills

Capcut Edit 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 Edit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Capcut Edit this skillrenezander030/capcut-cli832—~1.4kAutomated safety check: PassMIT
KinocutKyaniteLabs/kinocut192—~5.7kAutomated safety check: PassApache-2.0
Kinocut RepurposeKyaniteLabs/kinocut192—~1kAutomated safety check: PassApache-2.0
AutoshortsUpload-Post/skill-autoshorts150—~5.3kAutomated safety check: NotesMIT
Stage EditOrkas-AI/Orkas-VideoStudio497—~2.4kAutomated safety check: PassMIT
Web Demo Video SynthesisSven-LI-sankyuu/presentation-skills175—~3.2kAutomated safety check: PassNone

Similar skills

  • 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…

    192 GitHub stars~5.7k tokensUpdated yesterday
    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.

    192 GitHub stars~1k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Autoshorts

    Upload-Post/skill-autoshorts

    Daily pipeline that picks one long video from a folder, transcribes it with Whisper, uses Gemini 3 Flash multimodal to find every viral short-form moment, cuts each candidate with FFmpeg, adds a…

    150 GitHub stars~5.3k tokensUpdated 5 mo ago
    Media & CreativeAuto-check: notes
  • Stage Edit

    Orkas-AI/Orkas-VideoStudio

    Intelligent editing of real user-supplied footage—understand it with transcript/inspected-frame/scene/silence/quality evidence, then choose deterministic timeline operations or a constrained…

    497 GitHub stars~2.4k tokensUpdated 15 days ago
    Media & CreativeAuto-check passed
  • Web Demo Video Synthesis

    Sven-LI-sankyuu/presentation-skills

    用于“网页 demo 分段配音 + timeline 驱动录屏 + 后期合成”的 workspace 协作流程:先搭建一个可审计工作目录(cues/timeline/segmentaudio/video/subtitles/final),再由人类 + Codex 迭代维护这些文件,按需只重跑局部步骤,最终合成高质量 MP4。适用于强调可复盘、可编辑、清晰度与字幕安全区可控的场景。

    175 GitHub stars~3.2k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Magic Hour Video Editing

    hashgraph-online/awesome-codex-plugins

    Edit or repurpose existing footage with Magic Hour, choosing between generative visual edits, subtitles, and precise local trim, crop or composition.

    1.2k GitHub stars~1.7k tokensUpdated yesterday
    Media & CreativeAuto-check passed

Works with

Questions about Capcut Edit

What does Capcut Edit do?

Edit CapCut / JianYing video projects — read and write subtitles, timing, speed, volume, templates, animations (fade/ken-burns), and cut long-form to shorts. Capcut Edit is an agent skill from renezander030/capcut-cli. Edit CapCut / JianYing video projects — read and write subtitles, timing, speed, volume, templates, animations (fade/ken-burns), and cut long-form to shorts.

When should I use Capcut Edit?

Capcut Edit fits situations like: the user mentions capcut; draftcontent.json; cutting videos — in English.

How do I install Capcut Edit in Claude Code?

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

How do I install Capcut Edit in Codex?

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

Can I use Capcut Edit 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 renezander030/capcut-cli --skill capcut-edit -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-edit, .gemini/skills/capcut-edit, .github/skills/capcut-edit and .opencode/skills/capcut-edit in your project.

What does Capcut Edit need to run?

Going by SKILL.md and its folder, Capcut Edit needs a shell for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3; A Bash shell.

Does Capcut Edit 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 Edit 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Capcut Edit use?

Capcut Edit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Capcut Edit use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.9k tokens, read only when the agent opens those files.

What are the alternatives to Capcut Edit?

Skills that share tags, products or a category with Capcut Edit: Kinocut (KyaniteLabs/kinocut, 192 stars), Kinocut Repurpose (KyaniteLabs/kinocut, 192 stars), Autoshorts (Upload-Post/skill-autoshorts, 150 stars) and Stage Edit (Orkas-AI/Orkas-VideoStudio, 497 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Capcut Edit?

renezander030 (a GitHub user) maintains it in renezander030/capcut-cli, which has 832 GitHub stars. The repository was last updated on October 4, 2026.

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