lalimi/claude-reelsmith

Finalise une vidéo montée dans CapCut — téléverse l'image (tout intégré), les pistes vocales et musicales, place les effets sonores de la bibliothèque CapCut sur chaque effet et transition, pousse un brouillon modifiable dans CapCut Web, et laisse le créateur échanger la musique et les sons à l'oreille avant l'exportation.

Qu'est-ce que claude-reelsmith ?

Ce skill transforme une vidéo montée localement (via `reelsmith build`) en un brouillon directement éditable dans CapCut Web, en automatisant toute la chaîne : upload des médias, placement des effets sonores depuis la bibliothèque CapCut ou des fichiers locaux, et création de la session de montage dans le cloud. Il est conçu pour les créateurs utilisant Claude Desktop ou tout agent compatible avec le protocole MCP, car il s'appuie sur le serveur CapCut MCP fourni dans le plugin. Le skill gère le téléversement des fichiers (vidéo, voix, musique), la validation des tailles, la génération d'un JSON de brouillon, et la poussée de ce brouillon via l'API CapCut (start_stdraft_session puis push_stdraft_snapshot). Il évite d'écraser les modifications faites par le créateur dans l'éditeur en lisant d'abord le brouillon existant. L'utilisateur reçoit une URL d'édition web pour ajuster la musique et les effets sonores à l'oreille avant export.

Compatible avec✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/lalimi/claude-reelsmith/tree/HEAD/skills/reel-capcut

Documentation

Brouillon Reel → CapCut

Nécessite : un reel construit (reelsmith build <dir>), le serveur MCP CapCut (capcut, intégré dans le .mcp.json de ce plugin ; connectez-vous une fois via /mcp), et le bundle de plugin CapCut sur le disque pour le téléverseur et le générateur de brouillon (voir $(reelsmith root)/docs/capcut.md, variable d'environnement CAPCUT_PLUGIN_DIR, défaut ~/capcut-plugin).

Étapes

Ajoutez "sfx" dans reel.json — une entrée par événement à l'écran :
```
"sfx": [{"name": "whoosh", "t": 6.9, "vol": 0.5}, {"name": "click", "t": 30.62, "vol": 0.5},
        {"name": "typing", "t": 2.5, "vol": 0.35, "dur": 1.4}, {"name": "my_sounds/rip.mp3", "t": 15.36}]
```
Noms de bibliothèque : whoosh, whoosh-short, pop, typing, click, sparkle, coin, chime, impact, shutter, ding (ids dans engine/capcut.py). Tout autre nom = un fichier audio local que vous possédez, téléversé avec les pistes.
reelsmith capcut stems <dir> → out/capcut/{video.mp4, voice.wav, music.wav} + files.json. La voix et la musique partagent un gain (somme = −14 LUFS) et un limiteur ; la musique est déjà atténuée sous la voix.
Téléversement : appelez capcut_asset_upload_credential avec version: 2 et pour chaque fichier son file_name + size_bytes exacts (revérifiez les tailles juste avant ; une erreur de correspondance échoue avec upload_files_mismatch). Ensuite printf '%s' <ticket> | node "${CAPCUT_PLUGIN_DIR:-$HOME/capcut-plugin}"/x/plugins/codex/skills/capcut-upload/scripts/capcut-upload.mjs --files "$(cat out/capcut/files.json)" --upload-ticket-stdin --json > out/capcut/upload.json
reelsmith capcut draft <dir> → out/capcut/draft.json (validé).
start_stdraft_session → push_stdraft_snapshot avec base_package_id: "" et le JSON du brouillon. Donnez au créateur l'web_editor_url.
Avant de repousser, récupérez get_stdraft_snapshot et construisez dessus — le créateur a peut-être modifié le brouillon (la relecture est avec perte ; n'écrasez jamais leurs changements aveuglément). Pour les petites corrections (couper la queue musicale, volume) préférez les faire dans l'éditeur via Claude dans Chrome.

Ce qu'il faut dire au créateur

Écoutez d'abord : les sons de la bibliothèque CapCut sont signalés comme apparaissant sur la timeline mais silencieux. Si c'est le cas, remplacez-les dans Audio → Effets sonores, ou utilisez des fichiers locaux.
Musique : coupez la piste de substitution et choisissez un morceau de la bibliothèque à l'oreille ; découpez-le à la longueur de la vidéo (un morceau plus long ajoute une queue noire à l'export).
Export (en haut à droite → Télécharger, 1080p / 30 fps / MP4) sauvegarde d'abord dans le cloud CapCut : si l'espace cloud est plein, l'export échoue avec "Impossible de sauvegarder" — libérez de l'espace dans votre espace CapCut ou conservez le MP4 du moteur.
La recherche de sons propre au connecteur (search_capcut_material) est une mauvaise recherche par titre sans aperçus ; la bibliothèque sonore complète n'est disponible que dans l'application CapCut.