Communitygithub.com

capcut-editor

Video and animation skill. Professional video editing in CapCut desktop through the `capcut` MCP server (create_project, add_video, add_text, add_subtitles, save_project...). Use whenever the user asks to make, cut, edit or assemble a video, Reels, TikTok, Shorts, YouTube video, ad, montage, slideshow or captions "in CapCut", or asks Claude to edit their footage. Also triggers on Turkish requests such as "CapCut'ta video yap", "kurgula", "reels hazırla", "altyazı ekle", "montaj yap".

¿Qué es capcut-editor?

capcut-editor is a Claude Code agent skill that video and animation skill. Professional video editing in CapCut desktop through the `capcut` MCP server (create_project, add_video, add_text, add_subtitles, save_project...). Use whenever the user asks to make, cut, edit or assemble a video, Reels, TikTok, Shorts, YouTube video, ad, montage, slideshow or captions "in CapCut", or asks Claude to edit their footage. Also triggers on Turkish requests such as "CapCut'ta video yap", "kurgula", "reels hazırla", "altyazı ekle", "montaj yap".

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/batuhantncr16/capcut-mcp/tree/HEAD/skills/capcut-editor

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

CapCut editor

You build CapCut projects; the user opens them in CapCut, reviews, and exports. Tools come from the capcut MCP server. If those tools are missing, tell the user the server is not loaded (see the project README) and stop; do not fall back to clicking around CapCut.

Workflow (always in this order)

  1. Brief. Get (or infer and state) platform, aspect, target length, tone, footage folder, music, language of on-screen text. Ask at most one question; otherwise pick the defaults below.
  2. Inventory. List the footage folder, then probe_media every clip you may use. Never guess durations; never place a trim past a clip's real length. Note vertical vs horizontal sources. Look at the material (contact sheet of first frames) before choosing shots.
  3. Edit plan. Before any tool call, write a short shot list: 00.0-02.5 hook: clipA 3.0-5.5 + text "...". Totals must add up to the target length.
  4. Build. create_project -> video track(s) -> overlays -> audio -> text/captions -> effects/keyframes. Keep a timeline cursor so clips on main are gap-free: next target_start = previous target_start + (end - start) / speed.
  5. Save.
    • save_project(target="native") writes the project straight into CapCut's library and keeps effects, transitions, animations and keyframes. Tell the user to open it from CapCut's home screen (restart CapCut if it does not show up).
    • save_project(target="xml") (default) writes a portable .fcpxml the user imports (CapCut home -> Import project). It always opens but drops effects/transitions/animations/ keyframes; relay the warnings as an "add in CapCut" list.
    • Re-saving updates the same project until CapCut has opened it. After that the server saves to " v2" (CapCut rejects drafts rewritten after it opened them). Relay that warning and tell the user which project to open.
  6. Verify. If you can export (or the user exports), check the result with ffmpeg: duration, loudness, and blackframe for black frames; look at a contact sheet of frames every few seconds for text overflow, wrong positions and empty shots.
  7. Hand-off note. What to check in CapCut (fonts, music sync), export settings (1080p, 30 fps, or 60 fps if the source is 60 fps).

Coordinates

x, y are in [-1, 1], 0 = center, x = -1 left, y = -1 top, y = 1 bottom in every tool (text, video, image, sticker, subtitles, position_y keyframes). The server converts to CapCut's internal convention; never pre-flip values yourself.

Defaults by platform

Platformaspectlengthnotes
Reels / TikTok / Shorts9:1615-60 s (max 180 s)hook in the first 1.5 s, captions on, safe zone
YouTube16:9as neededlower thirds, chapters as title cards
Instagram feed4:515-60 scaptions on
Ad / promo9:16 + 1:16 / 15 / 30 slogo + CTA last 2-3 s

Horizontal footage in 9:16: add_video(..., background_blur=3) or a punch-in (scale ~1.8) centered on the subject. Never leave black bars. A vertical video of 180 s or less becomes a YouTube Short (no custom thumbnail); above 180 s it is a normal video.

Pacing and cutting (short-form retention)

  • The swipe decision happens in the first ~1.5 s: the first frame must already carry the hook (strong visual + on-screen hook text, no fade-in, no logo intro).
  • A new visual event at least every 2-3 s; no single shot over ~4 s without an internal event (punch-in keyframe, text pop, cut). Calm/luxury content may run 3-5 s.
  • Vary shot size between consecutive cuts; avoid two similar shots back to back.
  • Cut on beat when the music has a pulse (120 BPM -> cut lengths in multiples of 0.5 s).
  • Transitions: default is a hard cut on the beat. Stylised transitions (see recipes below) mark section changes and returns to the presenter, roughly one every 10-15 s, 0.15-0.35 s long, always with a sound effect.
  • Motion on stills/static shots: slow push-in with add_keyframes uniform_scale 1.0 -> 1.08 per clip; alternate push-in / pull-out; never exceed 1.2 unless it is a deliberate punch-in. Give each clip its own keyframes and end them a hair before the next clip starts.
  • A persistent progress device helps long Reels (e.g. a year/chapter badge that updates).
  • End on a frame that loops back to the opening shot; keep the CTA short.

Intro and transition recipes

Ready-made recipes come from list_options("recipe") (CapCut names, timing, how to build them with these tools, matching SFX). Measured on a high-retention science Short:

RecipeWhenCapCutTimingSFX
whip_inopening, back to presentertransition Horizontal_Blur / Left / Right0.3 s, ease-outwhoosh
whip_out_looplast shot to black, loops into the openingHorizontal_Blur, outro Slide_Left0.3 swhoosh
punch_injump cut inside a talking-head takekeyframe uniform_scale 1.0 -> 1.18 in 1 frameevery 4-8 snone
flash_whipbig reveal / topic changeWhite_Flash0.25-0.35 sriser + impact
strobe_montageenergy burst, listsStrobe or 2-frame alternating clips0.3-2.5 sticks / stutter
glitchAI, tech, "something is wrong"Glitch, RGB_Glitch0.13-0.2 sglitch (loudest SFX)
blinksleep, dreams, memoryBlink0.3-0.4 ssoft whoosh close/open
black_flickerbeat before a key lineeffect Black_Flash2 frameslow thump
  • Put a transition on the clip before the cut (transition=, transition_duration=).
  • Match the transition to the topic; pair every one with an SFX peaking ~0.1 s after the cut.
  • add_video has no intro animation: open on the hook frame (never on black); for a whip on frame 0 use a photo with add_image(..., intro_animation="Slide_Left") or tell the user to add Animation > In > Slide Left in CapCut.
  • Strobe montages: keep under ~3 flashes per second (photosensitive viewers).

Text and captions

  • Safe zone for 9:16: keep text between y = -0.65 and y = 0.55, x within +-0.8. Hook around y = -0.35 ... -0.5; captions around y = 0.35 ... 0.5.
  • Hook: 2-7 words, size 14-20, bold, white or yellow with border_width 40-45 black, visible on the first frame (no intro animation on the very first text).
  • Captions: add_subtitles with an SRT; size 16-22 for 9:16; 2-4 words per cue, 1-3 s each. The server re-wraps cues at word boundaries (wrap_chars, automatic by default) so CapCut never splits a word. Build the SRT from word timings when you have them (TTS alignment).
  • Key numbers and claims as separate pop-up labels (size 12-16) timed to the spoken word.
  • No emoji in text: CapCut renders them at a huge fixed size (the server warns).
  • Turkish and other non-ASCII text: keep correct characters (ç, ğ, ı, İ, ö, ş, ü); pick fonts that support them (e.g. Inter_Black, Poppins_Bold) or leave font unset.
  • One font family per video (max two: display + body). Overlapping texts on different tracks.
  • Never cover faces or the product with text.

Audio

  • Separate tracks: vo, music, sfx (use two SFX tracks when effects overlap; clips on one track must not overlap).
  • Levels: VO 1.0; music under speech 0.15-0.25; music alone 0.6-0.8; SFX 0.3-0.6. Mute source audio of B-roll (volume=0).
  • Lock SFX to the moment they illustrate (whoosh on section cuts, impact on reveals, riser before a twist, typewriter on dates).
  • Only use music the user provided, generated, or confirms they have rights to. Fade-outs are done in CapCut (mention it).

Effects

  • Effects are seasoning: at most one look effect per section (Retro_Film for archive eras works well). Search names with list_options("scene_effect", q).
  • Some effects render wrongly; list_options marks them in known_broken and add_effect refuses them (e.g. Camera_Shake renders solid black in CapCut 9.8 exports).
  • Keyframe brightness/contrast/saturation adjustments stay within +-0.2.

Quality checklist before save_project

  • No gaps or accidental overlaps on main; total length matches the brief.
  • Every trim within the clip's probed duration.
  • Hook visible on frame 0; CTA/logo at the end if promotional.
  • Text inside the safe zone, readable, spelled correctly, no emoji.
  • Audio levels per the table; B-roll muted.
  • Aspect matches the platform; no black bars.
  • Relay every warnings entry from tool results to the user.

Scripting large builds

For 50+ tool calls (long Reels, many captions) you may drive the same functions from Python in one go; they are plain functions in capcut_mcp.server:

import capcut_mcp.server as cc
pid = cc.create_project("My Reel")["project_id"]
cc.add_video(pid, "/path/clip.mp4", end=3)
cc.save_project(pid, target="native")

Skills relacionados