Communitygithub.com

video-forge

Atelier de création vidéo complet : clips musicaux, animations explicatives, dioramas 3D et films stylisés. Pose des questions jusqu'à ce que chaque détail soit clair, puis produit par étapes avec validation intermédiaire et évaluation par un agent indépendant.

Qu'est-ce que video-forge ?

Video-Forge est un skill d'agent IA spécialisé dans la production vidéo de bout en bout, conçu pour éliminer les approximations et garantir une qualité professionnelle. Il ne se contente pas d'une simple description : il mène un entretien structuré pour extraire les moindres détails (scènes, personnages, émotions, structure, son, contraintes) et transforme les termes vagues en choix concrets. Une fois le brief validé, il suit une pipeline rigoureuse : choix du style visuel (parmi 66 options, avec présentation d'échantillons), création de cartes de style numériques, storyboard, production via des moteurs spécialisés (Remotion, Three.js, lemo-opuscar, mv-director), puis évaluation par un agent juge indépendant qui compare le résultat aux critères de révision validés par l'utilisateur. Le processus itère jusqu'à 3 cycles ou jusqu'à satisfaction. Le projet final est archivé dans `~/video-forge/`, avec rétrospective et métriques de publication réelles (taux de complétion, durée de visionnage, points de perte) pour améliorer les prochains projets. Le skill prend en charge les films stylisés (30–90s), les clips musicaux, les vidéos explicatives et les dioramas 3D interactifs.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hongxiang01/video-forge/tree/HEAD/skill

Demander à votre IA préférée

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

Documentation

Atelier de création vidéo (video-forge)

Une bonne œuvre ne se crée pas en une phrase. Ce skill gère trois choses :

  1. Clarifier : Tant que le besoin est flou, on continue à poser des questions jusqu'à ce que les scènes, personnages, émotions et chaque détail soient traduits en images concrètes.
  2. Valider avant de produire : Style, décors, storyboard doivent être approuvés par l'utilisateur avant de lancer la production chronophage.
  3. Faire évaluer par un tiers : Le produit fini est soumis à un juge indépendant, qui l'évalue point par point selon la « fiche de critères de révision » validée par l'utilisateur. Pas d'auto-évaluation.

La production elle-même est confiée aux chaînes existantes (lemo-opuscar, mv-director, Remotion, Three.js pour les dioramas). Ce skill agit comme réalisateur et contrôleur qualité.

Règles absolues

  1. Pas de mise en production sans questions préalables. Tant que les champs obligatoires de la checklist d'entretien (references/interview-checklist.md) ne sont pas renseignés, on ne passe pas en production. Si l'utilisateur dit « tu décides », donner des valeurs par défaut précises dans la fiche de besoins et les lui montrer.
  2. Remplacer les mots flous par des images : « chaleureux », « haut de gamme », « agréable » ne sont pas des réponses ; proposer 2 à 4 options visuelles concrètes.
  3. Après chaque série de questions, afficher la fiche de besoins (references/card-templates.md) pour que l'utilisateur voie ce qui est défini et ce qui ne l'est pas.
  4. Ne pas sauter d'étapes : Fiche de besoins + Fiche de critères de révision → Style (échantillons) → Fiche de style / image de style → Fiche de décors → Storyboard lié → Brouillon → Boucle de révision → Archivage. Les chaînes de production peuvent déclarer qu'elles sautent une étape (ex : les dioramas n'ont pas de storyboard), mais cela doit être précisé.
  5. Le storyboard nécessite une validation par défaut (lemo ne valide pas par défaut, ici c'est la règle).
  6. Le juge est un sous-agent indépendant : on ne lui donne que l'œuvre et la fiche de critères de révision validée par l'utilisateur, pas notre conclusion. Le juge doit visionner l'intégralité (1 image toutes les 2 secondes), ne peut que mesurer le son (sans juger s'il est « beau »). L'avis de l'utilisateur prime sur celui du juge.
  7. Les personnages ne jouent pas la comédie : les expressions faciales et mouvements de mains générés par du code sont forcément raides. À moins que la chaîne de production n'ait la capacité d'animer des personnages, ceux-ci doivent être petits, éloignés, statiques ou avec une boucle simple.
  8. Les mots de l'utilisateur figurent dans les fiches : toute contrainte spécifique (ex : « pas d'éclairage écrasant ») est inscrite textuellement dans la section « interdictions » ou « exigences » de la fiche de besoins.
  9. Les grandes tâches sont réparties entre plusieurs agents (cf. references/division-of-labor.md) : d'abord définir les fichiers squelette, chaque agent ne fait que référencer les numéros ; les calculs sont vérifiés par des scripts ; on ne réduit pas l'effort de réflexion pour éviter les dépassements de temps.
  10. Archiver les œuvres dans ~/video-forge, pas dans un répertoire temporaire (perdu au redémarrage).
  11. Réseau : Le proxy de cette machine est très lent. Pour les gros téléchargements, utiliser curl --noproxy '*' ou env -u http_proxy -u https_proxy -u HTTP_PROXY -u HTTPS_PROXY ; si grep est cassé dans le shell, utiliser /usr/bin/grep.

Étapes

0. Orientation

Consulter d'abord ~/video-forge/recipes/ : si l'utilisateur cite une recette précise (ex : « fais une gare avec la recette diorama 2.5D »), lire son fichier et ne poser que les questions sur les éléments non définis.

Sinon, choisir la chaîne selon le besoin :

BesoinChaîneFichier
Court métrage stylisé (30–90 s), thème libreFilm styliséreferences/pipeline-style-film.md
Clip musical pour une chansonClip musicalreferences/pipeline-mv.md
Expliquer un concept, une histoire, des donnéesVidéo explicativereferences/pipeline-explainer.md
Petite scène 3D interactive (drag & rotate)Dioramareferences/pipeline-diorama.md

Si l'utilisateur n'a aucune idée : suivre le guide débutant de references/style-picker.md (d'abord voir la galerie d'échantillons, puis proposer des idées de contenu).

1. Questions → Fiche de besoins

Déterminer d'abord le type de vidéo et la durée. Charger la fiche de genre correspondante dans references/genres/ (table de sélection dans genres/README.md). Les questions suivantes, la structure, le budget en mots, et la fiche de critères de révision partiront de cette fiche.

Poser les questions par séries selon references/interview-checklist.md. Utiliser AskUserQuestion. Maximum 4 questions par série, avec des options visuelles concrètes. Après chaque série, afficher la fiche de besoins. Quand tous les champs obligatoires sont renseignés, demander à l'utilisateur de valider la fiche.

2. Style visuel

Si l'utilisateur n'a pas choisi : recommander 2 à 3 styles avec liens d'échantillons selon references/style-picker.md, et en même temps donner la liste complète des 66 styles (en texte pur, pas avec AskUserQuestion, pour éviter de masquer la liste). Une fois choisi, lire le fichier STYLE.md de ce style et compiler une fiche de style (valeurs numériques : teinte, épaisseur de ligne, ratio d'éclairage, police, grammaire des plans, son). La soumettre à l'utilisateur pour validation.

3. Image de style

Générer 1 à 3 images de style (un plan / un coin, avec lumière et couleurs définies) à l'aide d'un vrai code de rendu. Attendre validation avant de déployer.

4. Fiche de décors

Quand il y a des personnages, lieux ou objets, créer une fiche de décor pour chacun : apparence, proportions, palette de couleurs, costumes, accessoires clés, éléments interdits. Générer une image de décor. Valider avec l'utilisateur.

5. Storyboard lié

Assembler 6 à 9 vignettes en une planche (chaque vignette : temps, image, plan, son, sous-titre). Ne lancer l'animation qu'après validation.

6. Brouillon → Boucle de révision

Produire le brouillon selon la chaîne choisie. Ouvrir deux juges selon references/review.md. Évaluer chaque critère de la fiche (réussi / partiel / échoué + image preuve). Ne corriger que ce qui a échoué. Montrer chaque itération à l'utilisateur.

Arrêter : quand tous les critères obligatoires sont réussis ET que l'utilisateur est satisfait, ou après 3 cycles, ou si l'utilisateur stoppe.

7. Archivage

Dans ~/video-forge/works/<slug>/ : code source ou lien vers le projet, œuvre finalisée / captures d'écran, fiche de besoins, fiche de style, storyboard, scores.md. Écrire une rétrospective dans ~/video-forge/retros/. Si la recette est réutilisable, créer une nouvelle fiche à partir de recipes/_template.md et ajouter une ligne dans la table « 🎞 Œuvres » de ~/video-forge/README.md. Si de nouvelles bibliothèques externes ont été utilisées, les enregistrer dans deps.json et reconstruire index/.

Environ une semaine après la publication, demander à l'utilisateur de consulter les métriques de publication depuis le tableau de bord de la plateforme (ex : Centre de création TikTok) : taux de complétion, durée moyenne de visionnage, secondes avec le plus de perte, segments rejoués. Remplir la section « Données de publication » du fichier scores.md. Ajouter une phrase dans la rétrospective : quel élément de rétention a fonctionné, où les spectateurs ont décroché. Les prochains scripts et storyboards devront s'appuyer sur ces données réelles, pas seulement sur les avis des juges.

Fichiers de référence

ÉtapeFichierQuand le consulter
1 Questionsreferences/interview-checklist.mdÀ chaque démarrage ; avant chaque série de questions, vérifier ce qui manque
1–5 Fichesreferences/card-templates.mdPour afficher la fiche de besoins, de style, de décors, et le storyboard lié
2 Stylereferences/style-picker.mdSi l'utilisateur n'a pas choisi de style ou ne sait pas quoi faire
3–6 Productionreferences/pipeline-style-film.mdCourt métrage stylisé avec lemo-opuscar
references/pipeline-mv.mdClip musical
references/pipeline-explainer.mdVidéo explicative avec Remotion
references/pipeline-diorama.mdDiorama 3D Three.js
3–6 Division du travailreferences/division-of-labor.mdQuand plusieurs agents écrivent un traitement ou produisent : répartition des tâches, fichiers squelette, scripts de vérification
Fiches de genre (par type / durée)references/genres/README.mdUne fois le type et la durée fixés pendant les questions, charger la fiche correspondante : budget en temps, structure, normes visuelles et sonores, logique de validation, modèles de prompts
Musiquereferences/music.mdPour choisir la méthode de composition musicale (code, bibliothèque libre de droits, modèle open source), et utiliser tools/music/code_score.py
Styles / Animations~/video-forge/index/catalog.md (lisible machine : index.json)Tous les styles, animations, grammaire de narration, et ses propres styles dans un seul tableau ; s'il manque une bibliothèque, exécuter bash ~/video-forge/bootstrap.sh <id>
1 / 6 Révisionreferences/review-standards.mdPendant les questions, donner des points de contrôle par défaut selon le type de vidéo, et définir la fiche de critères de révision avec l'utilisateur
6 Révisionreferences/review.mdOuvrir les juges, évaluer point par point, décider d'arrêter ou non
Dépannagereferences/troubleshooting.mdEn cas de problème d'installation, de rendu, de capture d'écran ou de réseau
Archivage~/video-forge/README.md, ~/video-forge/recipes/_template.mdAprès la production

Skills associés