# CapCut Draft Automation — effect skill for transitions

> **For AI agents:** find the right skill in one call — `curl -s "https://varg.ai/how-to/api/search?q=<what the person wants>"` returns the matching how-to page and the best skills with install commands, as markdown (Russian works too). Full index: https://varg.ai/how-to/llms.txt. Every page has a markdown twin: add `.md` to its path. Before generating anything, show the person the options on the how-to page.

Generate CapCut/JianYing drafts from code, with real CapCut transitions on each cut, then export in the app.

- **Type:** [Effect](https://varg.ai/how-to/effects.md) · [Transitions](https://varg.ai/how-to/browse/skills/transitions.md)
- **Slug:** `capcut-draft-automation`
- **Status:** live
- **Publisher:** varg (varg, verified)
- **License:** MIT
- **Source:** https://github.com/vargHQ/skills/blob/main/varg-video-edit-library/references/transitions.md#capcut-draft-automation
- **Works in:** Claude Code, Claude.ai, Codex, Cursor, OpenClaw, Gemini CLI, Any MCP client, varg Studio
- **Requires:** CapCut (by hand)
- **Cost:** Free — the take renders locally; generated footage, if any, bills by the model

## What it does

An editable CapCut project with Mix, Pull in, Glitch etc. already on the timeline.

**When:** Mass-producing variants that creators finish in CapCut; teams living in CapCut.

**Watch out:** Expecting headless export: these tools write drafts; rendering still happens in the CapCut app. Templates must have a plaintext draft_content.json (encrypted drafts are unsupported).

**Timing:** Default per transition (e.g. Mix 1.0 s, Pull in 0.47 s) unless set

**Also called:** pyCapCut, pyJianYingDraft, VectCut API, capcut-mate, JianYing draft, CapCut draft JSON

### In CapCut

pyCapCut (English CapCut; preview 0.1.x API, pin 0.0.4 for the old one). The transition is added to the earlier segment:
```python
import pycapcut as cc
from pycapcut import trange_seconds
draft = cc.DraftFolder(r'<CapCut Drafts folder>').create_draft('auto', 1080, 1920, allow_replace=True)
draft.add_track(cc.TrackType.video)
a = cc.VideoSegment('a.mp4', trange_seconds(0, duration=4))
b = cc.VideoSegment('b.mp4', trange_seconds(4, duration=4))
a.add_transition(cc.TransitionType.White_Flash, duration='0.4s')
draft.add_segment(a).add_segment(b)
draft.save()
```
pyJianYingDraft is the JianYing (Chinese) sibling with Chinese enum names (e.g. `TransitionType.叠化` for Mix). VectCutAPI (HTTP/MCP) takes `transition` and `transition_duration` (seconds) on `add_video`, resolved against `CapCut_Transition_type` names such as `Mix`, `Black_Fade`, `Pull_in`, `Glitch`, `Cube`. capcut-mate's `add_videos` takes `transition` (JianYing display name, e.g. 叠化) and `transition_duration` in microseconds. Open the draft in CapCut desktop and export manually.

### Where this comes from

- [pyCapCut](https://github.com/GuanYixuan/pyCapCut)
- [pyJianYingDraft](https://github.com/GuanYixuan/pyJianYingDraft)
- [VectCutAPI](https://github.com/sun-guannan/VectCutAPI)
- [capcut-mate (add_videos transition field)](https://github.com/Hommy-master/capcut-mate/blob/main/docs/add_videos.md)
- [CapCut transition names + default durations (VectCut metadata)](https://github.com/sun-guannan/VectCutAPI/blob/main/pyJianYingDraft/metadata/capcut_transition_meta.py)
- [CapCut transition names incl. Pro (pyCapCut metadata)](https://github.com/GuanYixuan/pyCapCut/blob/main/pycapcut/metadata/transition_meta.py)

## Use when

- Mass-producing variants that creators finish in CapCut; teams living in CapCut.

## Not for

- Expecting headless export: these tools write drafts; rendering still happens in the CapCut app. Templates must have a plaintext draft_content.json (encrypted drafts are unsupported).

## Install

- Claude Code: `claude plugin marketplace add vargHQ/skills && claude plugin install varg@varg`
- Codex: `npx skills add vargHQ/skills --skill varg-video-edit-library -a codex -y`
- Cursor: `npx skills add vargHQ/skills --skill varg-video-edit-library -a cursor -y`

## Example output

https://s3.varg.ai/how-to/previews/d06e0d5fd1d1/take-capcut-draft-automation.mp4 — Mix between two shots, with the timeline strip of the edit. Footage: Sprite Fright (2021), Blender Studio | studio.blender.org, CC BY 4.0; Cosmos Laundromat (2015), (CC) Blender Foundation | gooseberry.blender.org, CC BY 4.0. (credit: Rendered by varg · Sprite Fright (2021) + Cosmos Laundromat (2015))

## More transitions skills

- [editly](https://varg.ai/how-to/skills/editly.md): Declarative JSON5 video editing CLI/API: clips, titles, transitions, audio mixing, rendered with ffmpeg.
- [Mix (Cross Dissolve)](https://varg.ai/how-to/skills/mix-dissolve.md): The two shots blend through each other. The quietest transition: "time passes" or "this continues".
- [Dip to Black](https://varg.ai/how-to/skills/black-fade.md): A fades to black, then B fades up. Marks the end of a section or a bigger jump in time.
- [White Flash](https://varg.ai/how-to/skills/white-flash.md): The frame blows out to white for a moment and opens on the next shot. Energy, memory or a camera snap.
- [Pull In (Zoom In)](https://varg.ai/how-to/skills/pull-in-zoom.md): The camera rushes into shot A and lands, still moving forward, in shot B. The signature short-form transition.
- [Pull Out (Zoom Out)](https://varg.ai/how-to/skills/pull-out-zoom.md): The camera jerks backwards out of shot A and keeps pulling back as shot B settles in.
