/brag
Vous l'avez construite. Maintenant, vantez-vous.
Répartition de l'invocation (doit être effectuée en premier)
Vérification du modèle. Si vous êtes Claude Opus 5.5 et que l'invocation ne demande pas le workflow complet (--full, "utilise le brag complet") ni la voix off (--voice, que brag-slim ne gère pas), basculez sur brag-slim : lisez <skill-dir>/slim.md (la compétence /brag-slim, incluse ici) et suivez-la pour le reste de cette session au lieu de ce fichier. Transmettez l'entrée de l'utilisateur ainsi que les autres options (--no-music, --title, …) sous forme d'instructions en langage naturel. Informez d'abord l'utilisateur en une ligne, par exemple "Vous êtes sur Opus 5.5, j'utilise donc /brag-slim : je construis la vidéo entièrement moi-même. Dites 'utilise le brag complet' pour revenir en arrière." Si vous êtes un autre modèle ou si vous ne pouvez pas déterminer votre modèle, ignorez cette vérification.
Avant d'inspecter le projet, analysez l'intégralité de l'invocation /brag. Si l'invocation contient --voice, définissez voice.enabled = true. Activez la narration uniquement pour cette session. N'activez pas la narration automatiquement et ne revenez 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. Elle est étroite, tranchée et amusante.
Ce que fait cette compétence
- Lit le code du projet actuel pour comprendre l'application.
- Planifie un concept de brag court 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 indicateurs :
/brag
/brag --tone chaotique
/brag --tone soigné --format vertical
/brag ça. Fais-le ressembler à un lancement de startup ridicule.
Analysez ces options :
| Option | Valeurs | Défaut |
|---|---|---|
--tone | préréglage ou description libre | déduit |
--format | paysage, portrait, carré | paysage |
--duration | secondes | auto (15-25s) |
--no-music | indicateur | musique activée |
--no-sfx | indicateur | effets sonores activés |
--title | chaîne | déduit du projet |
--voice | indicateur | narration désactivée |
La voix est optionnelle. Si --voice est présent, utilisez Kokoro via Hyperframes et n'ajoutez aucune logique de sélection de fournisseur. Le workflow vocal est intentionnellement mono-fournisseur.
Le ton peut être un préréglage (défaut, soigné, parodie-yc, chaotique, deadpan, cinématique, app-store) ou une direction créative comme "faux lancement Series A de 2016", "exposition de musée" ou "publicité de jeu mobile surproduite".
Lorsque l'utilisateur donne une direction de ton libre, associez-la au préréglage le plus proche pour le rythme et la structure, mais conservez la direction de l'utilisateur dans le plan et le brief de composition.
Guide de narration
Lorsque --voice est activé, rédigez une narration qui complète les visuels, ne se contente pas de lire le texte visible, correspond au rythme des scènes, sonne naturelle et conversationnelle, et se déroule harmonieusement entre les scènes. Gardez le script concis et spécifique au produit afin que la voix semble faire partie du montage plutôt qu'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 sessions précédentes, utilisez un répertoire horodaté :
brag-output-2026-05-04-143022/
Utilisez un horodatage lorsque :
- L'utilisateur demande explicitement une nouvelle session sans écraser les résultats précédents
- Un répertoire
brag-output/existe déjà dans le projet
Générez l'horodatage au début de la session (YYYY-MM-DD-HHmmss) et utilisez-le de manière cohérente pour tous les chemins de sortie de cette session : 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 d'autres agents, c'est là où la compétence a été installée. Les ressources groupées se trouvent sous <skill-dir>/assets/ et les scripts sous <skill-dir>/scripts/. Ne devinez pas un chemin d'installation : une installation de plugin, une copie dans ~/.claude/skills/ et ce dépôt les placent tous à des endroits différents.
Étape 1 : Inspecter le projet
Lire : references/step-1-inspect.md
Analysez le répertoire du projet et extrayez les informations nécessaires pour planifier la vidéo de brag.
Porte : Vous pouvez répondre aux 9 questions de la grille de planification du brag.
Étape 2 : Planifier et storyboarder
Lire : references/step-2-plan.md
Écrivez <output-dir>/brag-plan.md (où <output-dir> est brag-output/ ou la variante horodatée choisie ci-dessus). Répondez à la grille de planification. Engagez-vous sur un angle créatif. Rédigez le storyboard scène par scène, incluant les scènes, le texte, le timing, les transitions et les indications d'effets sonores.
Lorsque la musique est sélectionnée, incluez une section compacte Guide des repères musicaux : lisez le préréglage de repère du morceau groupé dans <skill-dir>/assets/music/cues/ s'il est présent, sinon notez que les repères seront détectés au moment de la composition (toute piste prend désormais en charge la synchronisation de rythme — voir references/audio.md). Les métadonnées de repère ne sont qu'une indication de timing facultative : l'histoire, la lisibilité, le rythme et la clarté du produit restent prioritaires.
Porte : <output-dir>/brag-plan.md existe avec un storyboard complet. Les durées des scènes totalisent 15 à 25 secondes.
Étape 3 : Transférer à Hyperframes
Lire : Les compétences de domaine Hyperframes — hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-keyframes, hyperframes-cli. /brag est son propre workflow : n'entrez pas dans l'entretien d'intention du point d'entrée hyperframes et ne l'orientez pas vers son workflow générique de promotion / vidéo de lancement.
Lire : references/step-3-compose.md
Lire : references/audio.md
Rédigez le brief de composition et utilisez Hyperframes pour créer l'implémentation vidéo dans <output-dir>/composition/.
/brag possède l'angle produit, le matériel source, le storyboard, le ton, le format, la sélection audio, les instructions de repère musical 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 réussit avec zéro erreur à l'intérieur de <output-dir>/composition/ (la seule porte navigateur avant le rendu — voir hyperframes-cli pour ce qu'il audite).
Étape 4 : Valider, rendre et livrer
Lire : references/step-4-deliver.md
Validez, prévisualisez, rendez dans <output-dir>/brag.mp4, choisissez la meilleure image d'affiche dans <output-dir>/brag.jpg, intégrez cette affiche comme image 0 de la vidéo afin qu'elle soit la vignette de veille partout, et écrivez <output-dir>/share-copy.txt.
Porte : <output-dir>/brag.mp4 existe. Une affiche de meilleure image <output-dir>/brag.jpg est choisie (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 ton sont livrés 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 |
|---|---|---|
défaut | Ludique, propre, publiable | La valeur par défaut de bonne humeur |
soigné | Sérieux, élégant | Pour les projets qui ne sont pas des blagues |
parodie-yc | Énergie startup impassible | Sérieux feint appliqué à des projets absurdes |
chaotique | Rapide, fort, agressif | Excessif et déjanté |
deadpan | Calme, sec, discret | La blague est que rien n'est une blague |
cinématique | Dramatique, à l'échelle d'une bande-annonce | Grand mouvement, plus grandes affirmations |
app-store | Fluide, propre carte de fonctionnalité | Corporate mais pas ennuyeux |
Permettez toujours une direction créative libre pour affiner ou remplacer le préréglage.
Lois créatives
Celles-ci s'appliquent à chaque vidéo de brag, quel que soit le ton.
Courte. 15 à 25 secondes. Pas une seconde de plus sans raison. Cela tient même si la narration est activée ; la narration n'étend pas la fenêtre.
Lisible. Gardez le rythme élevé grâce au mouvement et aux coupures, jamais en faisant clignoter du texte. Chaque ligne qu'un spectateur doit lire reste suffisamment longtemps pour être lue (étiquette courte ~0,8 s stable ; 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.
Montrez la chose. Au moins une scène doit afficher l'interface utilisateur réelle, le contenu ou un visuel clé du produit. Pas de remplissage abstrait.
Pas de langage SaaS générique. "Optimisez votre workflow" est interdit. Utilisez le contenu et les affirmations réels du projet.
L'accroche est primordiale. Les 2 premières secondes déterminent si quelqu'un continue à regarder. Planifiez l'accroche avant tout le reste.
L'humour a sa place. L'humour doit venir de l'absurdité du projet, pas de la tentative d'être drôle.
Motif :
Accroche (2-3s) → Révélation (2-4s) → 2-3 points forts marquants (5-12s) → Chute/outro (2-4s)
Adaptez-le. Tous les projets n'ont pas besoin d'exactement 3 points forts. Le motif est une forme de départ, pas un modèle.
Connecteurs disponibles
Utilisez muse.connector_search pour trouver la documentation du connecteur actuel avant de suivre des instructions récupérées.