Communitygithub.com

/reel : production vidéo pour Claude Code

Montre à un agent comment planifier, construire ou monter une « reel » afin que le résultat concret soit une vidéo finie. La procédure se déroule via /reel : production vidéo pour Claude Code, ordre de travail : d'abord la direction, puis le montage, Porte de livraison (obligatoire). Utilisez-la lorsqu'une nouvelle mission requiert ce métier.

Qu'est-ce que reel : production vidéo pour Claude Code ?

Le skill `/reel` est un outil de production vidéo intégré à Claude Code, construit sur ffmpeg. Il guide l'agent à travers un pipeline complet : de l'analyse du matériau brut à la livraison d'une vidéo finale, en passant par la rédaction d'un brief, la sélection et la vérification de la voix, la planification des plans, le rendu et un processus de révision obligatoire. Le skill impose un ordre de travail strict : la direction (brief et storyboard) vient en premier, suivie du montage, et enfin une « porte de livraison » en plusieurs étapes (enregistrement du brief, audition vocale, vérification du rendu, révision finale et livraison) qui bloque toute sortie non conforme. Il prend en charge la production verticale (1080×1920 par défaut), les plans avec zoom, tracking, transitions, sous-titres incrustés, et la détection de sujets via OWLv2. Il nécessite ffmpeg et est conçu pour être exécuté dans un répertoire projet dédié. Il ne doit être utilisé que lorsque la tâche de l'utilisateur correspond explicitement à ce flux de travail spécifique ; sinon l'agent doit refuser poliment.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shuaige121/reel/tree/HEAD/skills/reel

Demander à votre IA préférée

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

Documentation

Que fait reel : production vidéo pour Claude Code ?

Un outil en couches construit sur ffmpeg. Vous (Claude) examinez le matériau, décidez quoi montrer et rédigez un plan ; le code s'occupe de la géométrie du cadrage, du rendu et des vérifications. La taille de sortie est configurable (par défaut vertical 1080×1920).

Les commandes et formats de fichiers sont documentés dans docs/ENGINE.md du dépôt reel. Lisez-le avant la première commande : cat "$(reel --root)/docs/ENGINE.md". reel <command> --help liste toutes les options. Chaque commande imprime un objet JSON ({"ok": true, "result": ...} ou {"ok": false, "error": {"code": ..., ...}}) et se termine avec un code 1 en cas d'échec.

Ordre de travail : d'abord la direction, puis le montage

Pour toute vidéo qu'une autre personne que l'utilisateur verra, suivez SOP.md : S0 réception, S1 pack source, S2 inventaire des actifs, S3-S4 un agent director écrit direction/BRIEF.md et un storyboard, puis montez immédiatement (l'étape d'approbation G1 ne bloque pas par défaut), puis la porte de livraison ci-dessous. En S7, un agent director distinct révise le montage par rapport au BRIEF. Installé comme plugin, l'agent s'appelle reel:director.

  • Donnez au réalisateur les chemins du matériau original, pas vos propres conclusions à son sujet.
  • Si un BRIEF approuvé existe et que le but, le public et la portée du matériau n'ont pas changé, suivez-le.
  • Si l'utilisateur dit que la vidéo est ennuyeuse ou inutile, revenez à S3 et repensez la pièce ; ne vous contentez pas de remonter.

Porte de livraison (obligatoire)

Chaque étape est imposée par le code : en sautez une et vous ne pouvez pas livrer un montage final.

  1. Rédigez d'abord le brief ($P/brief.json, modèle ci-dessous) et enregistrez-le : reel register brief.json. Langue de livraison, finale ou échantillon, dossier de livraison et ce qui ne doit pas changer : si vous ne pouvez pas remplir ces champs, demandez à l'utilisateur. Une fois enregistré, le crochet Bash de protection refuse les écritures cp/mv/ffmpeg dans le dossier de livraison.
  2. Auditionnez la voix. Il n'y a pas de voix par défaut. Choisissez-en une qui correspond au brief, générez un échantillon de 10 à 20 s et exécutez reel voice check sample.mp3 --script sample.txt --brief brief.json. Le whisper local retranscrit l'échantillon et le compare au texte (--lang par défaut en ; pour une voix-off en chinois passez --lang zh, qui compare en pinyin sans tons, donc l'orthographe homophone n'est pas considérée comme une erreur) ; seul un taux d'erreur de 10 % ou moins inscrit l'approbation dans brief.voice.approved (by : claude, avec la transcription comme preuve). Si l'utilisateur a écouté, enregistrez ses mots exacts à la place.
    • La STT prouve que les mots sont lus correctement et clairement. Elle ne prouve pas que la voix convient à la pièce : dites dans votre réponse que vous avez choisi la voix, et changez de voix dans la version suivante si l'utilisateur ne l'aime pas.
    • Une nouvelle voix nécessite une nouvelle vérification. La voix macOS say est réservée aux brouillons internes, jamais pour une vidéo livrée.
  3. Vérifiez le rendu : reel check final.mp4 --plan plan.json --brief brief.json [--profile vertical-strict|project-profile.json] [--text caption.txt].
    • Un code de sortie 1 signifie qu'il ne peut pas être livré. Lisez result.gate.blockers (échecs techniques : même un échantillon ne peut pas être livré) et result.gate.pending_review (éléments qu'un relecteur doit examiner).
    • Ne vous fiez pas uniquement à ok. result.gate.not_covered liste ce qui n'a pas été vérifié (par exemple le texte à l'écran, qui n'a pas d'OCR) ; ne dites jamais que ces éléments ont été vérifiés.
  4. Révisez. Examinez chaque élément needs_review (reel scrub, captures d'écran) et rédigez un enregistrement de révision par élément avec des observations temporelles. Regardez l'intégralité du montage vous-même et signez final_watch (au moins une image par plan) ; écoutez du début à la fin et signez final_listen (une signature d'agent nécessite des observations temporelles ; si l'utilisateur a écouté, enregistrez ses mots exacts comme quote). Lorsque vous avez signé les deux, livrez-le comme final : le reçu indique approved_by : agent, et votre réponse dit « montage final, révisé par Claude, pas encore vu par vous ». Les retours de l'utilisateur deviennent la version suivante. Le format reviews.json se trouve dans docs/ENGINE.md.
  5. Livrez : reel deliver final.mp4 --brief brief.json --version v3 --plan plan.json --reviews reviews.json.
    • Si les conditions finales ne sont pas remplies, la commande échoue avec DELIVERY_NOT_FINAL et liste les raisons. Alors seul --sample est possible : le nom du fichier porte sample-pending-review, et vous devez l'appeler échantillon lorsque vous le dites à l'utilisateur.
    • Un numéro de version ne peut être livré qu'une fois ; les anciennes versions ne sont jamais supprimées ni écrasées. Seulement lorsque l'utilisateur demande explicitement de supprimer les anciennes versions : reel register brief.json --remove, supprimez, puis enregistrez à nouveau.
  6. Dire « terminé » nécessite un reçu avec status : final (reel receipt <receipt.json> le revérifie). Sinon, indiquez le vrai statut : « pas fini », « échantillon en attente de révision », « voix non auditionnée ». Le crochet Stop bloque une prétention d'achèvement qui n'a pas de reçu correspondant.
  7. Les vidéos réalisées par le script de rendu d'un projet (build_*.py et autres), ou composées dans un autre outil et exportées, passent également par les étapes 3 à 6.
{"version": "reel.brief.v1", "name": "spring-promo", "language": "en", "deliverable": "final",
 "delivery_root": "~/Videos/deliveries/spring-promo", "must_not_change": ["end card credit"],
 "voice": {"mode": "recorded"}, "profile": "default"}
  • voice.mode : none (pas de voix), recorded (un véritable enregistrement), tts ou clone (ces deux derniers nécessitent aussi voice_id et un bloc approved écrit par reel voice check, ou une approbation humaine avec quote, sample et sample_sha256).
  • delivery_root doit être un chemin absolu existant (ou commencer par ~). Il ne peut pas être le dossier personnel, Bureau, Documents, Téléchargements, la racine iCloud Drive, le dossier du projet ou un de ses parents.
  • Une version silencieuse utilise un profil projet : {"extends": "default", "audio": "silent"}.
  • Profils : default (seuils généraux de départ) et vertical-strict (1080×1920 30 ips, -16 LUFS, strict). Mettez les différences de projet dans un profil projet avec extends ; enregistrez les longues tenues prévues dans allow avec une raison ; ajoutez les mots bannis (anciens noms de produits, texte de remplissage) à text.extra_banned.

En haut de chaque appel Bash

Chaque appel Bash démarre un nouveau shell, donc commencez chaque appel par :

REEL_PROJECT=spring-promo                      # ce nom de projet
command -v reel >/dev/null || { echo "reel n'est pas dans le PATH (activez le plugin, ou exécutez ./install.sh --link)" >&2; return 1 2>/dev/null || exit 1; }
command -v ffmpeg >/dev/null || { echo "ffmpeg introuvable" >&2; return 1 2>/dev/null || exit 1; }
P="${REEL_PROJECTS_DIR:-$HOME/reel-projects}/$REEL_PROJECT"; mkdir -p "$P/preview" && cd "$P"

Toutes les sorties vivent dans $P, jamais dans un dossier temporaire ; les chemins relatifs ci-dessous sont relatifs à $P.

Réalisation du montage

Vous prenez les décisions (quels plans, quel sujet, mouvements de caméra, rythme) ; la perception, la géométrie, le rendu et les vérifications sont effectués par le code. La syntaxe complète des commandes se trouve dans docs/ENGINE.md.

  1. Matériau dans $P (actifs, observations.json, plan.json, aperçus, rendus et rapports de vérification y vivent tous ; un plan par dossier).
  2. Script et voix. Rédigez le script de voix-off, choisissez une voix qui correspond au brief et réussissez l'audition (étape 2 de la porte). Produisez voice.mp3 (ou .wav) et, si vous voulez des sous-titres, voice.vtt. Pour un travail publié, préférez un véritable enregistrement ou une voix dont la licence couvre l'utilisation ; pour un morceau uniquement musical, pointez audio.voice vers la piste musicale (c'est l'ancre de la timeline).
  3. Regardez et sélectionnez les cibles : reel inspect (lister chaque fichier) → reel frame (lire l'image avec la grille 0-1 et lire la boîte du sujet) → reel observe pour l'enregistrer, ou reel locate --query ... --check-png ... (OWLv2 ; regardez l'image de vérification avant d'utiliser une détection).
  4. Écrivez plan.json (EditPlan v1) : camera : [] maintient l'image fixe ; zoom_to avec un observation_id pousse sur un sujet enregistré ; utilisez track lorsque le sujet se déplace dans une vidéo ; transition_out pour les transitions. Ne laissez pas un plan vidéo traverser une coupe de scène signalée par inspect. audio.voice est requis et se résout par rapport à src_dir.
  5. Validez et prévisualisez : reel validate → reel compile → reel preview plan.json s2 --out preview/s2.mp4 --sheet preview/s2.png, puis lisez la planche contact pour juger du mouvement de caméra.
  6. Rendu : reel render plan.json --out "$P/final.mp4" --sheet "$P/preview/final.png" --where local (utilisez --where remote uniquement si l'utilisateur a configuré un GPU distant et l'a demandé). Le fait de passer les vérifications de rendu signifie seulement que le fichier n'est pas corrompu ; continuez avec les étapes 3 à 6 de la porte.

Autres points d'entrée, chacun avec une section dans docs/ENGINE.md :

  • Inspectez et modifiez la timeline : reel timeline (--format text ou une image --png multitrack), reel scrub (images autour de chaque coupe), reel edit / undo / history, reel preview --range (aperçu basse résolution avec son).
  • Coupez au tempo : reel beats music.mp3 --out beats.json → reel snap plan.json --beats beats.json --mode downbeat ; puis vérifiez chaque coupe avec reel timeline --png --beats. Nécessite ./install.sh --beats.
  • Narrez une page web avec des surlignements : un plan avec kind : "web" ; les positions du texte proviennent du DOM (pas d'OCR), donc une phrase surlignée doit correspondre exactement au texte de la page ; reel words voice.mp3 donne le timing mot par mot. Nécessite ./install.sh --web.
  • Projets Shotcut : reel mlt project.mlt --video-only ; --dupes trouve les séquences source utilisées deux fois.

Disponible : assemblage de plans, push-ins sub-pixel sur une boîte sujet, suivi d'un sujet en mouvement, transitions xfade, sous-titres incrustés, musique de fond, étalonnage et LUTs, plans web, recherche de sujet OWLv2, vérifications techniques, livraison avec porte. Pas intégré : transitions avec easing, interpolation d'images, clonage vocal.

GPU distant (optionnel)

Les parties --where remote sont imposées par le code.

  • Utilisez-le uniquement lorsque l'utilisateur a configuré REEL_REMOTE (une destination ssh) et le demande ; sinon effectuez le rendu avec --where local.
  • L'utilisation de la VRAM est plafonnée à 80 % par défaut. Quand un travail en nécessite davantage, l'outil renvoie NEED_USER_APPROVAL : informez d'abord l'utilisateur, et ajoutez --allow-over-80 uniquement avec son consentement. Une utilisation GPU de 50 % ou plus signifie que quelqu'un d'autre l'utilise ; ne le prenez pas.
  • Un travail GPU reel à la fois (verrouillage de fichier distant). Ne modifiez pas les limites de puissance. Ne redémarrez ni n'éteignez jamais l'hôte.
  • reel remote probe rapporte l'hôte ; reel remote setup-vision installe un venv séparé avec torch et les poids OWLv2 sur l'hôte distant.

Fichiers compagnons

  • SOP.md : workflow direction d'abord, rôles, étapes et conditions de sortie.
  • L'agent director (agents/director.md dans le dépôt) : brief, storyboard et révision.
  • docs/ENGINE.md dans le dépôt : commandes, EditPlan, brief, révisions, reçus et profils.

Skills associés