/showfolio
Tu l'as construit. Maintenant, montre-le.
Lancement de l'invocation (doit être fait 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 showfolio complet") ou une voix off (--voice, ce que showfolio-slim ne gère pas), bascule vers showfolio-slim : lis <skill-dir>/slim.md (le skill /showfolio-slim, inclus ici) et suis-le pour le reste de cette exécution au lieu de ce fichier. Transmets la saisie de l'utilisateur, et transmets toute autre option (--no-music, --title, …) comme une direction en langage clair. Informe l'utilisateur en une ligne d'abord, par exemple "Vous êtes sur Opus 5.5, j'utilise donc /showfolio-slim : je construis la vidéo moi-même. Dites 'utiliser le showfolio 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'invocation complète de /showfolio. Si l'invocation contient --voice, mets 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.
/showfolio transforme le site web ou l'application du projet actuel en une vidéo de démonstration soignée et partageable utilisant Hyperframes, présentée comme un projet construit par Octacer. C'est précis, tranché et amusant.
La marque Octacer est toujours activée. Les écrans du projet lui-même apparaissent exactement tels qu'ils sont, et le cadre qui les entoure (intro animée du logo, titres, arrière-plans, étiquettes, logo en coin, outro) est celui d'Octacer. Règles et ressources : references/brand.md et <skill-dir>/assets/brand/.
Ce que fait ce skill
- Pose à l'utilisateur trois questions de prise d'informations (durée, quoi mettre en avant, objectif) et obtient des identifiants de test si l'application nécessite une connexion.
- Lit le code du projet actuel pour comprendre l'application.
- Planifie un concept de démonstration spécifique à ce projet.
- Scénarise et storyboarde la vidéo dans le cadre de la marque Octacer.
- Transmet un brief de composition ciblé à Hyperframes.
- Valide, rend et écrit le texte de partage.
Analyse de l'invocation
L'utilisateur peut invoquer avec du langage naturel ou des flags :
/showfolio
/showfolio --duration 60
/showfolio --tone polished --format vertical
/showfolio ce projet. Fais-le ressembler à un film produit premium.
Analyse ces options :
| Option | Valeurs | Défaut |
|---|---|---|
--tone | préréglage ou description libre | inféré |
--format | landscape, vertical, square | landscape |
--duration | secondes (environ 40, 60 ou 90) | demandé à l'étape 0 |
--no-music | flag | musique activée |
--no-sfx | flag | effets sonores activés |
--title | chaîne | inféré du projet |
--voice | flag | 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 est intentionnellement mono-fournisseur.
La tonalité peut être un préréglage (default, polished, yc-parody, chaotic, deadpan, cinematic, app-store) ou une direction créative comme "fausse levée de fonds série A de 2016", "exposition de musée" ou "publicité de jeu mobile surproduite".
Quand l'utilisateur donne une direction de tonalité libre, mappe-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.
Conseils pour la narration
Quand --voice est activé, écris 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éplace en douceur 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 showfolio-output/. Pour éviter d'écraser les exécutions précédentes, utilise un répertoire horodaté :
showfolio-output-2026-05-04-143022/
Utilise un horodatage quand :
- L'utilisateur demande explicitement une nouvelle exécution sans écraser les résultats précédents
- Un répertoire
showfolio-output/existe déjà dans le projet
Génère l'horodatage au début de l'exécution (YYYY-MM-DD-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 du skill
<skill-dir> est le répertoire contenant ce SKILL.md. Claude Code l'affiche comme "Répertoire de base pour ce skill" au chargement du skill ; pour les autres agents, c'est là où le skill a été installé. Les ressources groupées sont dans <skill-dir>/assets/ et les scripts dans <skill-dir>/scripts/. Ne devine pas un chemin d'installation : une installation par plugin, une copie dans ~/.claude/skills/ et ce dépôt le placent tous à des endroits différents.
Étape 0 : Prise d'informations
Lis : references/step-0-intake.md
Pose à l'utilisateur les trois questions de prise d'informations (durée de la vidéo, fonctionnalités/pages à mettre en avant, objectif en une ligne) dans un seul message et attends les réponses. Ensuite, effectue la vérification de connexion : si les parties à montrer sont protégées par un login, utilise les identifiants donnés par l'utilisateur, sinon cherche des identifiants de test dans le dépôt, sinon demande-les à l'utilisateur.
Porte : Tu as une durée cible, une liste à montrer impérativement (avec la préférée de l'utilisateur marquée) et un objectif en une ligne. Si l'application nécessite une connexion, tu as des identifiants de test fonctionnels, ou l'utilisateur a dit de continuer sans.
É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. Accorde une attention particulière aux fonctionnalités et pages choisies par l'utilisateur à l'étape 0.
Porte : Tu peux répondre aux 9 questions de la grille de planification.
Étape 2 : Planifier et storyboarder
Lis : references/step-2-plan.md Lis : references/brand.md
Écris <output-dir>/showfolio-plan.md (où <output-dir> est showfolio-output/ ou la variante horodatée choisie ci-dessus). Réponds à la grille de planification. Engage-toi sur un angle créatif. Écris le storyboard mesure par mesure incluant les scènes, le texte, le timing, les transitions et les indices d'effets sonores.
Quand la musique est sélectionnée, inclus une section compacte Indications pour les repères musicaux : lis le préréglage de repères de la piste groupée depuis <skill-dir>/assets/music/cues/ s'il est présent, sinon note que les repères seront détectés au moment de la composition (toute piste supporte désormais la synchronisation sur le temps — voir references/audio.md). Les métadonnées de repères sont uniquement des indications de timing optionnelles : l'histoire, la lisibilité, le rythme et la clarté du produit restent prioritaires.
Porte : <output-dir>/showfolio-plan.md existe avec un storyboard complet. Chaque élément à montrer impérativement de l'étape 0 a une scène. Les durées des scènes totalisent la durée cible de l'étape 0, à ±10% près.
Étape 3 : Transmettre à Hyperframes
Lis : Les skills du domaine Hyperframes — hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-keyframes, hyperframes-cli. /showfolio est son propre workflow : n'entre pas dans l'entretien d'intention du point d'entrée hyperframes et ne t'oriente pas vers son workflow générique de promotion / lancement de vidéo.
Lis : references/step-3-compose.md
Lis : references/audio.md
Lis : references/brand.md
Copie <skill-dir>/assets/brand/ dans les ressources de la composition. Écris le brief de composition et utilise Hyperframes pour créer l'implémentation de la vidéo dans <output-dir>/composition/.
/showfolio possède l'angle produit, le matériel source, le storyboard, la tonalité, le format, la sélection audio, les indications de repères musicaux et les attentes de livraison. Hyperframes possède la structure concrète de la composition, 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, rend dans <output-dir>/showfolio.mp4, choisis la meilleure image d'affiche dans <output-dir>/showfolio.jpg, intègre cette affiche comme image 0 de la vidéo pour qu'elle soit la vignette au repos partout, et écris <output-dir>/share-copy.txt.
Porte : <output-dir>/showfolio.mp4 existe. Une affiche de meilleure image <output-dir>/showfolio.jpg est choisie (pas une image arbitraire) et intégrée comme image 0 de showfolio.mp4. Le texte de partage est écrit. Aucun identifiant n'apparaît dans aucun fichier de sortie ou image.
Système de tonalité
Sept préréglages de tonalité sont fournis avec /showfolio. 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
| Tonalité | Énergie | Phrase d'accroche |
|---|---|---|
default | Ludique, propre, publiable | La valeur par défaut de la bonne humeur |
polished | Sérieux, élégant | Pour les projets qui ne sont pas des blagues |
yc-parody | Énergie startup impassible | Sérieux factice appliqué à des projets absurdes |
chaotic | Rapide, fort, agressif | Excessif et débridé |
deadpan | Calme, sec, discret | La blague est que rien n'est une blague |
cinematic | Dramatique, à l'échelle d'une bande-annonce | Grand mouvement, plus 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 showfolio, quelle que soit la tonalité.
Cadre Octacer, produit réel. Les écrans du produit restent exactement tels qu'ils sont. Tout ce qui les entoure utilise la marque Octacer (Ink #040408, White, Lime #A3DC2F comme signal ; Space Grotesk, Montserrat, JetBrains Mono ; le logo SVG, jamais tapé). Ouvre avec le logo Octacer animé, ferme sur "Construit par Octacer". Voir references/brand.md.
La durée demandée par l'utilisateur. Atteins la cible de l'étape 0 (environ 40, 60 ou 90 secondes) à ±10% près. Remplis-la avec le produit, pas avec du remplissage : plus de fonctionnalités et des moments d'application en fonctionnement plus longs, jamais de pauses prolongées sur rien. Cela s'applique que la narration soit activée ou non ; la narration n'étend pas la fenêtre.
Mets en avant ce qu'ils ont demandé. Chaque page ou fonctionnalité nommée par l'utilisateur à l'étape 0 a sa propre scène. Celle qu'ils ont marquée comme préférée obtient le plus de temps d'écran et le placement le plus fort.
Vivant et rapide. 60 ips, mouvements de caméra rapides de 0,5 à 0,8 s, pas de dérives lentes, quelque chose de nouveau toutes les 2 à 3 s, le curseur qui clique dans la plupart des scènes produit, et la frappe en temps réel dans chaque chat ou boîte de saisie. Chiffres complets : "Règles de mouvement et de rythme" dans references/step-2-plan.md.
Lisible. Maintiens le rythme élevé par le mouvement et les coupes, jamais en faisant défiler du texte. Chaque ligne qu'un spectateur doit lire reste assez longtemps pour être lue (étiquette courte ~0,8 s stable ; une phrase ~0,3 s par mot). Entrée rapide, puis stable — jamais entrée rapide, puis disparue.
Spécifique. La vidéo doit donner l'impression d'avoir été faite pour ce projet exact, pas pour n'importe quel projet. L'objectif en une ligne de l'utilisateur est l'épine dorsale de l'histoire.
Montre la chose. La plupart des scènes affichent une véritable interface utilisateur, une copie ou un visuel clé du produit. Pas de remplissage abstrait.
Pas de langage SaaS générique. "Optimisez votre flux de travail" est interdit. Utilise la copie et les affirmations réelles du projet.
L'accroche est primordiale. Les 2 premières secondes déterminent si quelqu'un continue de regarder. Planifie l'accroche avant tout le reste.
L'humour a sa place. L'humour doit venir de l'absurdité du projet, pas d'une tentative d'être drôle.
Schéma :
Vignette Octacer (1,5-2,5 s) → Accroche (3-5 s) → Objectif/révélation (4-8 s) → un segment par fonctionnalité à montrer impérativement (6-15 s chacun ; la préférée obtient le plus long) → Outro avec logo Octacer (3-5 s)
Adapte cela. Dimensionne les segments de fonctionnalités pour que le total atteigne la cible. Le schéma est une forme de départ, pas un modèle.