/brag
Tu l'as construit. Maintenant, vante-toi un peu.
Répartition des invocations (doit se produire en premier)
Vérification du modèle. Si tu es Claude Opus 5.5 et que l'invocation ne demande pas le workflow complet (--full, « utilise le brag complet ») ou la voix off (--voice, que brag-slim ne gère pas), bascule vers brag-slim : lis <skill-dir>/slim.md (la compétence /brag-slim, intégrée ici) et suis-la pour le reste de cette exécution au lieu de ce fichier. Transmets l'entrée de l'utilisateur, et transmets toute autre option (--no-music, --title, …) comme instruction en langage clair. Informe l'utilisateur en une ligne d'abord, par exemple « Tu es sur Opus 5.5, donc j'utilise /brag-slim : je construis la vidéo moi-même. Dis « utilise le brag complet » pour revenir en arrière. » Si tu es un autre modèle, ou si tu ne peux pas déterminer quel modèle tu es, ignore cette vérification.
Avant d'inspecter le projet, analyse l'intégralité de l'invocation /brag. Si l'invocation contient --voice, définis voice.enabled = true. Active la narration uniquement pour cette exécution. N'active pas la narration automatiquement et ne reviens pas au workflow normal sans voix.
/brag transforme le site web ou l'application du projet actuel en une courte vidéo de lancement soignée et partageable, utilisant Hyperframes. C'est ciblé, pertinent et amusant.
Ce que fait cette compétence
- Lit le code du projet actuel pour comprendre l'application.
- Planifie un concept de vantardise court et spécifique à ce projet.
- Scénarise et storyboarde la vidéo.
- Transmet un brief de composition ciblé à Hyperframes.
- Valide, rend, et rédige le texte de partage.
Analyse de l'invocation
L'utilisateur peut invoquer avec du langage naturel ou des drapeaux :
/brag
/brag --tone chaotic
/brag --tone polished --format vertical
/brag ça. Donne-lui l'impression d'être un lancement de startup ridicule.
Analyse ces options :
| Option | Valeurs | Défaut |
|---|---|---|
--tone | préréglage ou description libre | déduit |
--format | landscape, vertical, square | landscape |
--duration | secondes | auto (15-25 s) |
--no-music | drapeau | musique activée |
--no-sfx | drapeau | effets sonores activés |
--title | chaîne | déduit du projet |
--voice | drapeau | narration désactivée |
La voix est optionnelle. Si --voice est présent, utilise Kokoro via Hyperframes et n'ajoute aucune logique de sélection de fournisseur. Le workflow vocal utilise intentionnellement un seul fournisseur.
Le ton peut être un préréglage (default, polished, yc-parody, chaotic, deadpan, cinematic, app-store) ou une direction créative comme « faux lancement de Série A de 2016 », « exposition de musée » ou « pub de jeu mobile surproduite ».
Lorsque l'utilisateur donne une direction de ton libre, associe-la au préréglage le plus proche pour le rythme et la structure, mais conserve la direction de l'utilisateur dans le plan et le brief de composition.
Consignes de narration
Lorsque --voice est activé, rédige une narration qui complète les visuels, ne se contente pas de lire le texte visible, correspond au rythme des scènes, semble naturelle et conversationnelle, et se déroule harmonieusement entre les scènes. Garde le script concis et spécifique au produit pour que la voix semble faire partie du montage plutôt que d'être une piste de narration séparée.
Répertoire de sortie
Par défaut, la sortie va dans brag-output/. Pour éviter d'écraser les exécutions précédentes, utilise un répertoire horodaté :
brag-output-2026-05-04-143022/
Utilise un horodatage lorsque :
- L'utilisateur demande explicitement une nouvelle exécution sans écraser les résultats précédents.
- Un répertoire
brag-output/existe déjà dans le projet.
Génère l'horodatage au début de l'exécution (AAAA-MM-JJ-HHmmss) et utilise-le de manière cohérente pour tous les chemins de sortie de cette exécution : plan, brief, composition, rendu et texte de partage.
Répertoire de la compétence
<skill-dir> est le répertoire contenant ce SKILL.md. Claude Code l'affiche comme « Répertoire de base pour cette compétence » lorsque la compétence se charge ; pour les autres agents, c'est là où la compétence a été installée. Les ressources intégrées se trouvent sous <skill-dir>/assets/ et les scripts sous <skill-dir>/scripts/. Ne devine pas un chemin d'installation : une installation via plugin, une copie dans ~/.claude/skills/ et ce dépôt le placent tous à des endroits différents.
Étape 1 : Inspecter le projet
Lis : references/step-1-inspect.md
Scanne le répertoire du projet et extrais les informations nécessaires pour planifier la vidéo de vantardise.
Porte : Tu peux répondre aux 9 questions de la grille de planification du brag.
Étape 2 : Planifier et storyboarder
Lis : references/step-2-plan.md
Écris <output-dir>/brag-plan.md (où <output-dir> est brag-output/ ou la variante horodatée choisie ci-dessus). Réponds à la grille de planification. Engage-toi sur un angle créatif. Rédige le storyboard plan par plan, incluant les scènes, le texte, le timing, les transitions et les indications d'effets sonores.
Lorsque la musique est sélectionnée, inclue une section compacte Indications de repères musicaux : lis le préréglage de repères du morceau intégré dans <skill-dir>/assets/music/cues/ s'il est présent, sinon précise que les repères seront détectés au moment de la composition (toute piste supporte désormais la synchronisation sur le rythme — voir references/audio.md). Les métadonnées des repères ne sont qu'une indication de timing optionnelle : l'histoire, la lisibilité, le rythme et la clarté du produit restent primordiaux.
Porte : <output-dir>/brag-plan.md existe avec un storyboard complet. La somme des durées des scènes est comprise entre 15 et 25 secondes.
Étape 3 : Passer la main à Hyperframes
Lis : Les compétences du domaine Hyperframes — hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-keyframes, hyperframes-cli. /brag est son propre workflow : n'entre pas dans l'interview d'intention du point d'entrée hyperframes et ne bifurque pas vers son workflow générique de promo/vidéo de lancement.
Lis : references/step-3-compose.md
Lis : references/audio.md
Rédige le brief de composition et utilise Hyperframes pour créer l'implémentation vidéo dans <output-dir>/composition/.
/brag possède l'angle produit, le matériau source, le storyboard, le ton, le format, la sélection audio, les indications de repères musicaux et les attentes de livraison. Hyperframes possède la structure de composition concrète, le timing d'animation exact, les mécanismes d'animation, les choix d'exécution, les règles de linting et le workflow de rendu.
Porte : npx hyperframes check passe avec zéro erreur dans <output-dir>/composition/ (la seule porte navigateur avant le rendu — voir hyperframes-cli pour ce qu'il audite).
Étape 4 : Valider, rendre et livrer
Lis : references/step-4-deliver.md
Valide, prévisualise, rends dans <output-dir>/brag.mp4, sélectionne la meilleure image d'affiche dans <output-dir>/brag.jpg, intègre cette affiche comme image 0 de la vidéo pour qu'elle soit la vignette de repos partout, et écris <output-dir>/share-copy.txt.
Porte : <output-dir>/brag.mp4 existe. Une meilleure image d'affiche <output-dir>/brag.jpg est sélectionnée (pas une image arbitraire) et intégrée comme image 0 de brag.mp4. Le texte de partage est rédigé.
Système de tons
Sept préréglages de tons sont fournis avec /brag. Chacun modifie l'énergie du script, le rythme, la personnalité typographique et le style de transition. Les préréglages sont des valeurs par défaut, pas des limites.
Définitions complètes : references/tones.md
| Ton | Énergie | Phrase d'accroche |
|---|---|---|
default | Ludique, propre, publiable | La valeur par défaut bonne humeur |
polished | Sérieux, élégant | Pour les projets qui ne sont pas des blagues |
yc-parody | Énergie startup impassible | Un sérieux factice appliqué à des projets absurdes |
chaotic | Rapide, bruyant, agressif | Excessif et déchaîné |
deadpan | Calme, sec, discret | La blague, c'est que rien n'est une blague |
cinematic | Dramatique, à l'échelle d'une bande-annonce | Grands mouvements, grandes promesses |
app-store | Fluide, propre comme une fiche fonctionnalité | Corporate mais pas ennuyeux |
Permets toujours une direction créative libre pour affiner ou remplacer le préréglage.
Lois créatives
Elles s'appliquent à chaque vidéo brag, quel que soit le ton.
Courte. 15-25 secondes. Pas une seconde de plus sans raison.
Lisible. Maintiens un rythme élevé par le mouvement et les coupes, jamais en faisant clignoter du texte. Chaque ligne qu'un spectateur doit lire reste assez longtemps pour être lue (étiquette courte ~0,8 s stabilisée ; une phrase ~0,3 s par mot). Entrée rapide, puis maintien — jamais entrée rapide, puis disparition.
Spécifique. La vidéo doit donner l'impression d'avoir été faite pour ce projet exact, pas pour n'importe quel projet.
Montre la chose. Au moins une scène doit afficher l'interface utilisateur réelle, le texte ou un visuel clé du produit. Pas de remplissage abstrait.
Pas de langage SaaS générique. « Rationalisez votre flux de travail » est interdit. Utilise le texte et les affirmations réels du projet.
L'accroche est tout. Les 2 premières secondes déterminent si quelqu'un continue à regarder. Planifie l'accroche avant tout le reste.
L'humour se gagne. L'humour doit venir de l'absurdité du projet, pas d'une tentative d'être drôle.
Motif :
Accroche (2-3 s) → Révélation (2-4 s) → 2-3 moments forts marquants (5-12 s) → Chute/Outro (2-4 s)
Adapte-le. Tous les projets n'ont pas besoin exactement de 3 moments forts. Le motif est une forme de départ, pas un modèle.