Communitygithub.com

Hasnan42/Showfolio

Transforme le projet Octacer actuel en une vidéo de démonstration soignée et aux couleurs d'Octacer (environ 40, 60 ou 90 secondes) en utilisant Hyperframes. L'écran du projet reste intact ; tout ce qui l'entoure (intro, titres, arrière-plans, outro, logo animé) utilise la marque Octacer. Pose d'abord trois questions rapides — durée, fonctionnalités à mettre en avant et objectif du projet en une ligne — puis demande des identifiants de test si l'application est protégée par un login. À utiliser quand quelqu'un dit "/showfolio", "faire une vidéo de démonstration", "créer une vidéo de présentation", "transformer ce projet en vidéo" ou souhaite montrer ce qu'il a construit. Lit le code du projet directement.

Qu'est-ce que Showfolio ?

Showfolio est un skill agent AI conçu pour transformer un projet web ou une application en une vidéo de démonstration professionnelle et partageable, en utilisant le framework Hyperframes. Il s'adresse aux développeurs et aux créateurs qui ont construit un projet et souhaitent le présenter de manière soignée, avec une marque Octacer cohérente autour de l'interface réelle du projet. Le skill pose trois questions initiales (durée de la vidéo, fonctionnalités à mettre en avant, objectif du projet en une ligne) et demande des identifiants de test si nécessaire. Il lit le code du projet pour comprendre l'application, puis planifie, storyboarde, compose et rend la vidéo. Showfolio prend en charge sept tonalités prédéfinies (par défaut, poli, parodie YC, chaotique, impassible, cinématique, App Store) ainsi que des directions libres. Les règles de création incluent le respect de la marque Octacer, la mise en avant des fonctionnalités demandées par l'utilisateur, un rythme rapide (60 ips), une lisibilité du texte, et une spécificité au projet. Le skill est conçu pour fonctionner avec Claude Code, Codex, Cursor et d'autres agents compatibles. L'utilisation de la voix (narration) est optionnelle et activée par le flag `--voice`. Le résultat final est une vidéo MP4 avec une vignette, des fichiers de composition, et un texte de partage.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Hasnan42/Showfolio/tree/HEAD/skills/showfolio

Demander à votre IA préférée

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

Documentation

/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

  1. 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.
  2. Lit le code du projet actuel pour comprendre l'application.
  3. Planifie un concept de démonstration spécifique à ce projet.
  4. Scénarise et storyboarde la vidéo dans le cadre de la marque Octacer.
  5. Transmet un brief de composition ciblé à Hyperframes.
  6. 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 :

OptionValeursDéfaut
--tonepréréglage ou description libreinféré
--formatlandscape, vertical, squarelandscape
--durationsecondes (environ 40, 60 ou 90)demandé à l'étape 0
--no-musicflagmusique activée
--no-sfxflageffets sonores activés
--titlechaîneinféré du projet
--voiceflagnarration 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éÉnergiePhrase d'accroche
defaultLudique, propre, publiableLa valeur par défaut de la bonne humeur
polishedSérieux, élégantPour les projets qui ne sont pas des blagues
yc-parodyÉnergie startup impassibleSérieux factice appliqué à des projets absurdes
chaoticRapide, fort, agressifExcessif et débridé
deadpanCalme, sec, discretLa blague est que rien n'est une blague
cinematicDramatique, à l'échelle d'une bande-annonceGrand mouvement, plus grandes promesses
app-storeFluide, 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.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés