Communitygithub.com

mfrancime/trident-archive

Génère des vidéos de démonstration produit de 2 minutes pour des projets techniques (dépôts GitHub, API, produits techniques). Exécute des options de construction en parallèle avec une revue critique structurée. À utiliser pour présenter du code, expliquer une architecture ou créer des vidéos explicatives.

Qu'est-ce que trident-archive ?

Cette compétence permet de générer automatiquement des vidéos de démonstration produit de 2 minutes pour des projets techniques, comme des dépôts GitHub, des API ou des produits techniques. Elle est particulièrement utile pour présenter du code, expliquer une architecture complexe ou créer des vidéos explicatives professionnelles rapidement. La compétence prend en charge deux approches de construction en parallèle : une vidéo animée avec Remotion, et une vidéo basée sur des diapositives avec Puppeteer et ffmpeg. Elle intègre également un système de revue critique avec deux personas (critique business et critique technique) qui évaluent et notent chaque vidéo. Le workflow se déroule en 7 phases : découverte du projet, rédaction du script, construction parallèle des deux options vidéo, revue critique parallèle, itération (jusqu'à 3 cycles), revue finale et livraison. La compétence utilise ElevenLabs pour la synthèse vocale et peut être exécutée sur des plateformes supportant les agents AI (comme Claude Code, Cursor ou Codex).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mfrancime/trident-archive/tree/HEAD/repos/trident_cc-crossbeam_hackathon_project/.claude/skills/product-demo-video

Demander à votre IA préférée

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

Documentation

Vidéo de Démonstration Produit

Générez des vidéos de démonstration produit de 2 minutes pour des projets techniques avec des options de construction parallèle et une revue critique structurée.

Quand l'utiliser

  • Pour présenter un dépôt GitHub, une API ou un produit technique
  • Besoin d'une vidéo explicative professionnelle rapidement
  • Vous voulez plusieurs approches (animée vs simple)

Workflow (7 Phases)

DÉCOUVERTE → SCRIPT → CONSTRUCTION PARALLÈLE → CRITIQUES PARALLÈLES → ITÉRATION → FINALE → LIVRAISON
   │           │           │                    │                  │            │         │
 5-10 min   10-15 min    30-60 min           10-15 min         0-3 boucles   porte    expédier

Phase 1 : Découverte

Cloner et analyser le dépôt :

gh repo clone <propriétaire/dépôt> /tmp/<dépôt>

Extraire :

  • Ce qu'il fait (1 phrase)
  • À qui il s'adresse
  • 3 à 5 fonctionnalités clés
  • Architecture / flux
  • Éléments visuels (logos, diagrammes)

Demander (ou utiliser les valeurs par défaut) :

QuestionValeur par défaut
Durée2 min
AudienceMixte (technique + business)
TonProfessionnel-conversationnel
FormatExplication animée

Phase 2 : Script

Utiliser la structure references/script-template.md :

Scène 1 : Accroche (0:00-0:15) — Énoncé du problème
Scène 2 : Contexte (0:15-0:30) — Pourquoi c'est important
Scènes 3-5 : Fonctionnalités (0:30-1:30) — 3 capacités clés, 20 secondes chacune
Scène 6 : Technique (1:30-1:50) — Architecture/crédibilité
Scène 7 : Appel à l'action (1:50-2:00) — Prochaines étapes

Recommandations :

  • 150 mots/minute
  • Maximum 20 mots/phrase
  • Voix active
  • Concret plutôt que vague

Phase 3 : Construction Parallèle

Lancer 2 sous-agents pour construire les options simultanément :

// Option A : Remotion (animé)
sessions_spawn({
  label: "demo-video-option-a",
  task: `Construire une vidéo de démonstration animée avec Remotion.
  
  Script : [coller le script]
  Voix : Utiliser ElevenLabs, ID vocal CcEB0ARKH8qIyzh2I1OR
  Sortie : /tmp/demo-video/option-a.mp4
  
  Approche :
  1. Générer la voix off par scène (API ElevenLabs)
  2. Créer un projet Remotion avec des composants de scène
  3. Synchroniser les animations avec le timing audio
  4. Rendre en 1080p 30fps`
})

// Option B : Diapositives + ffmpeg (simple)
sessions_spawn({
  label: "demo-video-option-b", 
  task: `Construire une vidéo de démonstration basée sur des diapositives.
  
  Script : [coller le script]
  Voix : Utiliser ElevenLabs, ID vocal CcEB0ARKH8qIyzh2I1OR
  Sortie : /tmp/demo-video/option-b.mp4
  
  Approche :
  1. Générer la voix off (API ElevenLabs)
  2. Créer des diapositives avec Puppeteer (HTML → PNG)
  3. Combiner avec ffmpeg, synchroniser avec l'audio
  4. Ajouter des transitions simples`
})

Attendre les deux. Présenter les options à l'utilisateur ou sélectionner automatiquement en fonction de la qualité.


Phase 4 : Critiques Parallèles

Lancer 2 personas de critique (voir references/ pour les grilles complètes) :

// Critique Business
sessions_spawn({
  label: "critic-business",
  task: `Examiner la vidéo de démonstration en tant que critique Business "Mike".
  
  Vidéo : [chemin]
  Script : [contenu]
  
  Voir references/critic-business.md pour le persona complet et la grille d'évaluation.
  
  Score : Clarté, Professionnalisme, Valeur Business (1-10 chacun)
  Sortie : Revue structurée avec score global et correctifs spécifiques.`
})

// Critique Technique
sessions_spawn({
  label: "critic-technical",
  task: `Examiner la vidéo de démonstration en tant que critique Technique "Ingénieur Senior".
  
  Vidéo : [chemin]
  Script : [contenu]
  
  Voir references/critic-technical.md pour le persona complet et la grille d'évaluation.
  
  Score : Précision Technique, Crédibilité, Complétude (1-10 chacun)
  Sortie : Revue structurée avec score global et correctifs spécifiques.`
})

Phase 5 : Itération

Portes de qualité :

PorteAction
Les deux critiques ≥7,5, aucun problème critique→ Expédier
Un critique <7,0 OU problème critique→ Itérer
Après 3 itérations, toujours en échec→ Escalader à un humain

Boucle d'itération :

  1. Collecter tous les problèmes critiques/importants
  2. Corriger par ordre de gravité
  3. Re-rendre uniquement les scènes affectées (si possible)
  4. Relancer les critiques

Phase 6 : Revue Finale

Avant d'expédier, vérifier :

  • Les deux critiques ont réussi (7,5+)
  • Aucun problème critique restant
  • Audio synchronisé correctement
  • Toutes les scènes rendues proprement
  • Appel à l'action clair

Phase 7 : Livraison

Sortie :

✅ Vidéo de démonstration terminée !

📹 Vidéo : demo-video-final.mp4 (2:03)
🎯 Audience : [cible]
📊 Scores : Business 8,2/10 | Technique 7,8/10

Couvre :
1. [Point clé 1]
2. [Point clé 2]  
3. [Point clé 3]

Fichiers sauvegardés dans : [emplacement]

Livrer à :

  • Canal Slack (si spécifié)
  • Sauvegarder dans workspace/outputs/

Outils et Dépendances

OutilObjectifRequis
ElevenLabsGénération voix offOui
RemotionFramework vidéo React (Option A)Un des A/B
ffmpegTraitement vidéo (Option B)Un des A/B
PuppeteerCaptures d'écran des diapositives (Option B)Un des A/B
sessions_spawnSous-agents parallèlesOui

Voix par défaut : CcEB0ARKH8qIyzh2I1OR (Jeremy - Narrateur de tutoriels techniques)


Références de fichiers

  • references/critic-business.md — Persona et grille d'évaluation du critique business
  • references/critic-technical.md — Persona et grille d'évaluation du critique technique
  • references/script-template.md — Structure de script scène par scène
  • templates/remotion/ — Structure du projet Remotion avec composants
  • scripts/generate-voiceover.py — Aide TTS ElevenLabs
  • scripts/render-slides.sh — Combinateur ffmpeg diapositive-vers-vidéo

Skills associés