JaviMaligno/agilabs-video-studio

Vidéo d'article

Orchestre l'ensemble du chemin, d'un article jusqu'à un MP4 finalisé. Les autres compétences contiennent les détails ; chargez-les à l'étape qui en a besoin :

• explainer-script : rédaction du script et choix d'un visuel par scène.
• explainer-animation : catalogue de composants, la timeline, composants sur mesure, images fixes.
• narration : TTS (Cartesia, Kokoro en fallback), prononciation, QA audio.

Le projet Remotion se trouve dans le dossier template/ du plugin (${CLAUDE_PLUGIN_ROOT}/template une fois installé en tant que plugin ; à côté de skills/ dans le dépôt du plugin).

Non-négociables

• Vérification des faits. Chaque nombre et chaque affirmation, à l'écran ou prononcés, est rattaché à une phrase de l'article. Conservez le tableau dans factcheck.md (affirmation, où elle apparaît, la phrase de l'article citée). Les chiffres sont affichés exactement comme l'article les écrit : même arrondi, mêmes unités, même "14/20" plutôt que "70%". Une discordance est corrigée dans la timeline, jamais dans l'article. La vérification des faits couvre la narration et les nombres et affirmations affichés à l'écran, rien d'autre. Les visuels sont choisis pour leur impact, pas comme une relecture littérale de l'expérience : une scène illustrative (données réelles rejouées librement, marqueurs placés pour plus de clarté, un mécanisme stylisé) est acceptable, car la rigueur réside dans l'article et son dépôt.
• Voix. La narration parle comme l'article est écrit : à la première personne ("J'ai réalisé...", "J'ai constaté..."), avec des affirmations pas plus fortes que celles de l'article. Si l'article tempère ("dans cette configuration", "sur ces 20 exécutions"), le script tempère aussi. Pas de formulation plus percutante que la source.
• Marque. AGILabs uniquement : le badge AGILabs et javieraguilar.ai. Aucun nom personnel nulle part, ni dans les cartes, l'affiche, les sous-titres ou les métadonnées du fichier.
• Validation obligatoire. Rien n'est construit avant que le script soit approuvé.

Flux de travail

1. Choisissez l'article. Utilisez celui qui est nommé. Si aucun n'est nommé, lisez les articles publiés et proposez 2-3 candidats, chacun avec son titre, un accroche, le nombre clé (cité) et une idée visuelle. Privilégiez les articles avec une expérience, un nombre clair et un mécanisme qui peut être dessiné. Laissez la personne choisir.

2. Rédigez le script avec explainer-script : les lignes de narration (EN, ES en option), une idée visuelle par scène mappée à un composant de la bibliothèque ou marquée "sur mesure", et la phrase source pour chaque nombre.

3. STOP pour validation. Montrez le script et attendez. Appliquez les modifications et montrez-le à nouveau si demandé.

4. Créez le dossier vidéo. Copiez le modèle sans ses fichiers générés :

   • dans le dépôt du plugin : examples/<slug-article>/ ;
   • depuis tout autre dépôt : ./video/<slug-article>/.

   rsync -a --exclude node_modules --exclude out --exclude public/audio --exclude public/music \
     --exclude .env "${CLAUDE_PLUGIN_ROOT}/template/" "video/<slug-article>/"
   cd "video/<slug-article>" && npm ci
   

   Enregistrez le script approuvé sous le nom script.md dans ce dossier.

5. Construisez la timeline avec explainer-animation : définissez src/settings.ts (articleTitle, voices, subtitles, targetSeconds, poster) et écrivez src/timeline.ts à partir du script. Ajoutez des composants sur mesure si le script en a signalé, chacun avec son test frameState.

6. Lint : npm run lint. Corrigez chaque problème détecté (durée, vitesse des sous-titres, composant inconnu). Lancez npm test aussi lorsqu'un composant a été ajouté ou modifié.

7. Vérification des faits par rapport à l'article et rédigez factcheck.md (voir ci-dessus).

8. Narration : npm run tts, puis npm run audio-qa (voir narration). Écoutez tout ce qu'il signale. Relancez npm run lint : les longueurs réelles des lignes remplacent les estimations.

9. Images fixes, et examinez-les. Rendu d'une image fixe par scène plus une toutes les 3 s environ et lisez chaque PNG. Vérifiez la marque, les zones de sécurité, rien ne dépasse, les nombres égaux à l'article, et les sous-titres en phase avec le rythme à l'écran. Une compilation propre ne prouve pas qu'une image est correcte.

10. Rendu : npm run render (vertical EN). -- --es pour la version espagnole, -- --landscape pour 1920×1080. Ensuite npm run audio-qa à nouveau pour mesurer le mix (-16 LUFS intégré).

11. Livraison : npm run deliver écrit le PNG de l'affiche, le SRT et out/manifest.json. Regardez l'affiche. Remettez le chemin du MP4 et l'affiche ; la publication est une étape séparée.

Rendu d'une vidéo existante

Ouvrez son dossier, lancez npm ci si node_modules est manquant, modifiez src/timeline.ts ou les paramètres, puis répétez à partir de l'étape 6. Le TTS ne regénère que les lignes dont le texte a changé.

Où vont les fichiers

• Le code source (timeline, paramètres, composants sur mesure, script.md, factcheck.md) est versionné.
• out/, public/audio/, public/music/, node_modules/ et tous les .mp4/.wav ne le sont pas.
• .env contient la clé TTS et n'est jamais versionné ni imprimé.