Communitygithub.com

/edit — montage en programme

Assemble les clips en un film fini dans le programme d'édition défini par `editor.id` dans `config.json`. Utilise MCP et l'utilisation de l'écran ensemble, ne génère jamais de média ni n'ajoute de musique.

Qu'est-ce que edit — montage en programme ?

La compétence **/edit** transforme les clips bruts en un film final, en travaillant dans le programme d'édition désigné par la clé `editor.id` du fichier `config.json`. Elle prend en charge plusieurs workflows : selon la configuration, l'agent peut soit monter seul avec ffmpeg (via la compétence `assemble`), soit piloter un logiciel comme DaVinci Resolve, Premiere Pro, Final Cut Pro ou CapCut en combinant MCP et utilisation de l'écran. L'agent vérifie d'abord que tous les clips sont présents, puis suit l'un des deux chemins : si `editor.id` est `none`, il utilise ffmpeg ; sinon, il utilise l'API MCP du programme pour les opérations précises (création du projet, importation des clips, placement sur la timeline) et l'utilisation de l'écran pour vérifier visuellement le résultat. Il ne fait jamais confiance aveuglément aux messages de succès, demande la permission avant de prendre le contrôle de l'écran, et ne génère jamais de musique ni de médias supplémentaires. Le rendu final est toujours produit dans `renders/final/film.mp4` et le fichier projet du logiciel est sauvegardé.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bidah/storyseam/tree/HEAD/.claude/skills/edit

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

/edit — clips → film, dans le programme que l'histoire nomme

Le film est monté là où l'auteur continuera à travailler dessus. config.json indique où :

"editor": { "id": "davinci_resolve", "mcp": true, "computer_use": true }
CléSignification
idnone — vous montez seul avec ffmpeg. Ou le programme : davinci_resolve, premiere_pro, final_cut_pro, capcut, ou tout autre nom donné par l'auteur.
mcptrue lorsque le serveur MCP de ce programme est installé et connecté dans votre client.
computer_usetrue lorsque vous pouvez piloter l'écran (Claude computer use, ou l'équivalent de votre outil).
notesTexte libre facultatif : version du programme, édition, emplacement du projet.

L'absence de clé editor équivaut à { "id": "none" }.

Étape 0 — vérifier les clips (chaque chemin)

Effectuez d'abord l'étape 1 de la compétence assemble, quel que soit l'éditeur : chaque bloc a un clip, dans l'ordre, à sa durée réelle. Un montage basé sur un bloc manquant est un film avec un trou.

Chemin A — editor.id: "none" : vous êtes l'éditeur

Suivez la compétence assemble. La sortie est renders/final/film.mp4. C'est toute l'étape.

Chemin B — un programme : monter dedans

B1. Vérifier ce que vous pouvez atteindre, puis l'annoncer

Avant de toucher à quoi que ce soit, confirmez ce que config.json déclare :

  • MCP : appelez un outil en lecture seule sur le serveur du programme (pour DaVinci Resolve, le listing des projets ou timelines). Si cela échoue, affichez la ligne d'installation de ce serveur depuis mcp_servers de config.json (npx storyseam mcp --agent <votre_agent> ; pour Resolve, npx davinci-resolve-mcp setup) et attendez. Ne mettez editor.mcp à false qu'après que l'auteur a confirmé que le serveur n'est pas censé être présent. Ne l'installez jamais vous-même.
  • Utilisation de l'écran : prenez une capture d'écran et confirmez que le programme est ouvert, ou peut être ouvert.

Informez ensuite l'auteur en une ligne du mode dans lequel vous allez travailler, et demandez avant de prendre le contrôle de l'écran : l'utilisation de l'écran déplace sa souris et son clavier.

B2. Travailler MCP et utilisation de l'écran ENSEMBLE

Ni l'un ni l'autre ne suffit seul, et les meilleurs résultats viennent de l'utilisation des deux à chaque étape :

  • MCP effectue le travail précis et reproductible : créer le projet et la timeline à la résolution et au taux d'images de l'histoire, importer renders/clips/block_NN.mp4 dans l'ordre des blocs, placer chacun sur V1/A1 bout à bout, ajouter des marqueurs par bloc depuis shotlist/shotlist.json, configurer les paramètres de rendu et lancer le rendu. Valeurs exactes et pas de mauvais clics.
  • L'utilisation de l'écran est vos yeux, et vos mains là où l'API s'arrête : capture d'écran après chaque étape MCP pour confirmer qu'elle a fait ce qui a été rapporté, parcourez chaque jointure dans le visualiseur et regardez les images de chaque côté, vérifiez les compteurs audio, et gérez tout ce que le MCP n'expose pas (une boîte de dialogue, un panneau, un glisser-déposer, un paramètre sans API).
  • Ne faites jamais confiance à un message de succès MCP que vous n'avez pas vérifié visuellement. Un clip importé à un mauvais taux d'images, une timeline à la mauvaise résolution ou une file de rendu vide rapportent tous un succès.

Lorsqu'un seul est disponible :

mcpcomputer_useComment vous travaillez
truetrueLes deux, comme ci-dessus. La valeur par défaut et la meilleure.
truefalseMCP uniquement. Dites que le montage n'est pas vérifié visuellement et demandez à l'auteur de parcourir les jointures lui-même.
falsetrueUtilisation de l'écran uniquement. C'est plus lent, prévenez l'auteur, et gardez des étapes petites avec une capture après chacune.
falsefalseVous ne pouvez pas piloter le programme. Écrivez renders/edit/timeline.edl (CMX 3600, un événement par bloc dans l'ordre, depuis shotlist.json et les durées réelles des clips), dites à l'auteur comment l'importer, et produisez également renders/final/film.mp4 via la compétence assemble pour qu'il y ait un film de toute façon.

B3. Le montage

  1. Un projet nommé d'après le title de storyseam.md, à la résolution et au taux d'images réels des clips (ffprobe un clip ; ne présumez pas).
  2. Une seule timeline. Les blocs sur V1 et leur audio sur A1, dans l'ordre, sans trous ni chevauchements.
  3. Un marqueur par bloc, nommé avec son identifiant de bloc et son premier plan.
  4. Laissez une piste musicale vide (A2) pour l'auteur. N'ajoutez jamais de musique. La partition est celle de l'auteur, dans assets/audio/music/.
  5. Rendez dans renders/final/film.mp4 (H.264, AAC, la résolution de la timeline), et sauvegardez le fichier projet du programme là où le programme le conserve. Enregistrez ce chemin dans editor.notes.

B4. Notes sur les programmes

  • DaVinci Resolve. Son serveur MCP pilote l'API de script de Resolve. Le script externe est réservé à Studio ; sur l'édition gratuite, le pont intégré à l'application (Workspace › Scripts) est le moyen d'accès, et sur la version gratuite 21.1+, le scripting Python a disparu, attendez-vous donc à vous appuyer sur l'utilisation de l'écran. Utilisez la page Edit pour la timeline et la page Deliver pour le rendu ; confirmez la file de rendu par une capture d'écran avant de la lancer.
  • Tout autre programme. Cherchez d'abord son serveur MCP. S'il n'y en a pas, c'est la ligne mcp: false ci-dessus. N'installez pas vous-même de logiciels, plugins ou serveurs MCP ; dites à l'auteur ce qui aiderait et laissez-le faire.

Dernière étape — rapport

Le chemin vers le film, sa durée réelle et sa résolution, le fichier projet du programme, le mode dans lequel vous avez travaillé (MCP + utilisation de l'écran, l'un des deux, ou EDL), tout ce que vous n'avez pas pu vérifier visuellement, et le fait qu'il n'y a pas de musique par conception.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés