Communitygithub.com

mikeOnBreeze/cc-crossbeam

Générez 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 parallèles 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 cc-crossbeam ?

Cette compétence permet de générer automatiquement des vidéos de démonstration produit de deux minutes pour des projets techniques, en orchestrant un flux de travail en sept phases, de la découverte à la livraison. Elle est particulièrement utile pour les développeurs et les ingénieurs souhaitant créer rapidement des vidéos explicatives professionnelles pour des dépôts GitHub, des API ou des produits techniques. La compétence prend en charge deux options de construction parallèles : une version animée avec Remotion et une version plus simple basée sur des diapositives avec Puppeteer et ffmpeg. Après la construction, deux agents critiques (business et technique) évaluent la vidéo de manière structurée sur des critères de clarté, de professionnalisme et d'exactitude technique. Le processus itératif permet d'améliorer la vidéo jusqu'à ce qu'elle franchisse des seuils de qualité prédéfinis, garantissant un résultat prêt à être partagé via Slack ou enregistré localement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mikeOnBreeze/cc-crossbeam/tree/HEAD/.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èles et une revue critique structurée.

Quand l'utiliser

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

Flux de travail (7 phases)

DÉCOUVERTE → SCRIPT → CONSTRUCTION PARALLÈLE → CRITIQUES PARALLÈLES → ITÉRATION → FINAL → LIVRAISON
   │           │           │                      │                    │            │         │
 5-10m      10-15m      30-60m                 10-15m              0-3 boucles  validation  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
  • Ressources visuelles (logos, diagrammes)

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

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

Phase 2 : Script

Utiliser la structure du fichier 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, 20s chacune
Scène 6 : Technique (1:30-1:50) — Architecture/crédibilité
Scène 7 : Appel à l'action (1:50-2:00) — Prochaines étapes

Directives :

  • 150 mots/minute
  • Maximum 20 mots/phrase
  • Voix active
  • Préférer le concret au 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 personnalités 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 la personnalité complète et la grille.
  
  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 la personnalité complète et la grille.
  
  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

Seuils de qualité :

SeuilAction
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 vers un humain

Boucle d'itération :

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

Phase 6 : Révision finale

Avant d'expédier, vérifier :

  • Les deux critiques ont réussi (7,5+)
  • Aucun problème critique ne subsiste
  • L'audio est synchronisé correctement
  • Toutes les scènes sont rendues proprement
  • L'appel à l'action est clair

Phase 7 : Livraison

Sortie :

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

📹 Vidéo : demo-video-final.mp4 (2:03)
🎯 Public : [cible]
📊 Scores : Business 8.2/10 | Technique 7.8/10

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

Fichiers enregistrés dans : [emplacement]

Livrer à :

  • Canal Slack (si spécifié)
  • Sauvegarder dans espace-de-travail/sorties/

Outils et dépendances

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

Voix par défaut : CcEB0ARKH8qIyzh2I1OR (Jérémy - Narrateur de tutoriels techniques)


Références de fichiers

  • references/critic-business.md — Personnalité et grille du critique Business
  • references/critic-technical.md — Personnalité et grille du critique Technique
  • references/script-template.md — Structure du script scène par scène
  • templates/remotion/ — Structure de projet Remotion avec composants
  • scripts/generate-voiceover.py — Assistant TTS ElevenLabs
  • scripts/render-slides.sh — Combinaison ffmpeg diapositive-vers-vidéo

Skills associés