Que fait DemoDay ?
Transforme un dépôt (GitHub ou dossier local) et son application web ou macOS native en une vidéo de démonstration de 45 à 75 secondes en 1080p, qui semble avoir été réalisée par le designer de l'application elle-même. L'outil est un CLI Node/TS fourni avec cette compétence. Vous êtes le réalisateur : vous écrivez le storyboard (plan.json) ; l'outil enregistre et effectue le rendu. Aucune clé API nécessaire.
0. Trouver et configurer l'outil (TOOL)
TOOL est le répertoire de base de cette compétence s'il contient package.json (l'installation normale : l'ensemble du dépôt cloné dans ~/.claude/skills/demoday). Sinon, il s'agit de ~/demoday. Si aucun des deux n'existe, arrêtez-vous et dirigez l'utilisateur vers les étapes d'installation dans le README.
Première exécution sur une machine (lorsque TOOL/node_modules est manquant) :
- Vérifiez
node --version(nécessite ≥ 20). S'il est manquant, demandez à l'utilisateur d'installer Node.js (brew install nodeou nodejs.org) et arrêtez-vous. - Exécutez
npm install && npx playwright install chromiumdansTOOL. Cela télécharge environ 300 Mo, prévenez donc l'utilisateur avant de commencer. - Pour une application Mac, vérifiez également
xcrun swiftc --version. S'il est manquant, demandez à l'utilisateur d'exécuterxcode-select --install. L'assistant se compile lui-même lors de la première utilisation.
Toutes les commandes ci-dessous sont exécutées depuis TOOL. OUT = out/<propriétaire>__<dépôt> (affiché par l'outil). Les vidéos restent dans TOOL/out/, indiquez donc le chemin complet à l'utilisateur.
1. Rassembler
npx tsx src/cli.ts <propriétaire/dépôt ou url github> [--url <url app live>] --prepare
Nécessite une URL web active (--url, sinon la page d'accueil du dépôt) — ou, pour une application macOS native, voir « Applications Mac natives » ci-dessous. Cela lit le dépôt et sonde l'application, en écrivant dans OUT :
prompt.md (règles du réalisateur + README + manifestes + arborescence des fichiers + instantané d'accessibilité), probe.png (capture d'écran du premier écran), probe.aria.yml.
Lisez prompt.md et examinez probe.png. Lisez src/schema.ts — c'est la structure exacte de plan.json, et les descriptions de ses champs sont des règles (limites de mots, ce que chaque beat doit faire).
2. Trouver l'histoire avant d'écrire quoi que ce soit
La vidéo repose sur deux éléments : pourquoi le statu quo est mauvais et ce qui rend ce produit spécial.
- Statu quo : le workflow concret que l'utilisateur cible effectue aujourd'hui sans ce produit, avec un coût temporel honnête par étape. Seules des affirmations équitables concernant des concurrents nommés.
- Spécial : le mécanisme qui rend cela possible (d'après le README/le code), pas des adjectifs. « Seul X … ».
- Lisez le code pour les fonctionnalités que le README sous-estime : une icône de bureau ou de barre de menus toujours présente, un raccourci clavier global, un stockage hors ligne/local, une mascotte. Ce sont souvent les vrais différenciateurs. Vérifiez chaque fonctionnalité que vous revendiquez dans le code avant de la mettre dans la vidéo.
- Si l'utilisateur vous a donné son positionnement, son concurrent ou son différenciateur, utilisez le leur. Si rien ne révèle ce qui le rend différent, posez une courte question avant d'écrire le plan.
3. Adapter le style de l'application (obligatoire)
La vidéo doit ressembler à une partie de l'application : mêmes couleurs, mêmes polices, même mascotte ou icône, même ton de voix. Un modèle de lancement sombre générique sur une application douce et pastel (ou vice versa) est perçu comme inapproprié. Les utilisateurs le remarquent immédiatement.
- Extrayez les tokens de design de l'application à partir du code :
- SwiftUI/AppKit: un fichier de style
Theme.swift,Assets.xcassets/*.colorset, des appelsColor(hex:). - Web: propriétés CSS personnalisées,
tailwind.config.*, fichiers de thème,<meta name="theme-color">. - Collectez : l'arrière-plan, le texte, la carte/panneau, l'accent, et les polices d'affichage/corps.
- Polices : privilégiez les fichiers de polices regroupés dans le dépôt (
Resources/Fonts/*.ttf,public/fonts, sources@font-face,next/font/local). - Mascotte/icône : sprites, l'icône de l'application (
AppIcon.icns→sips -s format png … --out icon.png), ou le logo SVG/favicon.
- SwiftUI/AppKit: un fichier de style
- Choisissez l'ambiance à partir de l'interface de l'application, pas de sa catégorie. Utilisez
mood: "soft"lorsque l'interface est légère, chaleureuse, ludique ou minimaliste. Utilisezbold(l'aspect sombre par défaut du lancement) lorsque l'application elle-même est sombre, technique ou à contraste élevé. - Remplissez
plan.look:"look": { "mood": "soft", "paper": "<bg app>", "ink": "<texte app>", "surface": "<carte app>", "fontFile": "<fichier police dépôt>", "bodyFontFile": "<optionnel>", "motifImage": "<png/svg icône/mascotte app>" }- Définissez
product.accentsur l'accent de l'application, dans la nuance lisible surpaper. Les accents en mode clair sont généralement le bon choix pour le mode doux. - Le texte atténué et les lignes sont dérivés automatiquement de
paper/ink. - Sans fichier de police, utilisez
display(Inter Tight, Pixelify Sans, Fredoka, Nunito). Pour prendre en charge une autre police Google, ajoutez-la àDISPLAYdansremotion/lib.tset à l'énumération du schéma. motif: "loaf"est un sprite de pixel-loaf intégré (applications de boulangerie uniquement). Sinon, utilisezmotifImage.- Le CLI copie ces fichiers dans
OUT/brand/. Les chemins peuvent être absolus ou relatifs à un dépôt local.
- Définissez
- Adaptez la voix : empruntez la microcopie et les métaphores de l'application pour les sous-titres et les titres (par exemple, la « pâte / levée / cuisson » d'une application de boulangerie).
- Minimal par défaut :
- Budget de copie : accroche ≤ 8 mots, environ 3 étapes de l'ancienne méthode, 3 lignes de comparaison, sous-titres de 2 à 5 mots, pas d'étiquettes ou de statistiques au-delà de l'essentiel.
- Trop de mots et un style d'avertissement rouge bruyant ont été les principales plaintes. L'aspect doux supprime déjà les compteurs, les étiquettes de douleur, les secousses et les tampons.
4. Écrire OUT/plan.json
Suivez les règles du réalisateur en haut de prompt.md. Règles d'enregistrement (newWay.actions) :
- Couvrez l'ensemble du cycle principal, pas seulement le chemin le plus court vers un résultat. Les utilisateurs remarquent quand les fonctionnalités phares sont absentes. Visez 10 à 20 actions (max 20), chaque fonctionnalité son propre beat sous-titré, effectuant le même travail que l'ancienne méthode et se terminant par le bénéfice. Web : la première action est
gotovers l'URL live. - Sous-titrez presque chaque action. Un beat sans sous-titre est perçu comme un temps mort par un spectateur en mode silencieux.
- Caméra : elle se rapproche de la zone cible de chaque action. Les actions
fill/pressnon ciblées visent le champ qui a le focus. L'enregistreur enregistre sa position après l'envoi des touches, et les plans de frappe zooment à 2× sur le début du texte. Les sous-titres se trouvent dans leur propre bande en dessous de la fenêtre et ne couvrent jamais l'application. Si un plan cadre la mauvaise chose, corrigez la cible. Ne modifiez pas les boîtes manuellement. - Les sélecteurs proviennent de l'instantané. Préférez
{role, name}copié textuellement (macOS :id, puisplaceholder, puisrole+name). Les entrées cachées dans les éditeurs de code sont correctes ; l'enregistreur clique sur leur conteneur visible. - Scénarisez les écrans plus profonds à partir d'instantanés réels, pas de suppositions :
- Écrivez un script jetable qui y navigue et se termine par un clic sur un
idinexistant. - Exécutez-le :
mac/.build/macdriver run --app X.app --out <brouillon> --script s.json -- --demo <brouillon>/data. Le fichier est{"actions":[…]}. Web : une exécution--from plan. - Lisez
failures[].ariadans<brouillon>/events.json.
- Écrivez un script jetable qui y navigue et se termine par un clic sur un
- Saisie : les valeurs
fillde plus de 80 caractères sont collées ; les plus courtes sont tapées visiblement. Utilisez des données réalistes, jamais « test ». Si des frappes disparaissent juste après un clic dans un nouveau champ (un titre tronqué, un champ vide, un clic ultérieur qui ne trouve pas le texte), divisez-le :clicksur le champ,wait500, puisfillnon ciblé. - Bénéfice : exactement une action a
emphasis: true. Placez-la sur unwaitfinal (~2000ms) avec un sous-titre, juste après le clic qui la déclenche, pas sur le clic lui-même. La caméra recule alors pour montrer l'ensemble du résultat, et les attentes d'emphase se jouent en temps réel. Les autres longues attentes sont accélérées. - Beat de lanceur : si l'application vit sous la forme d'une icône toujours présente (bureau, barre de menus) ou derrière un raccourci clavier global, définissez
plan.launcher(captions,hintoptionnel tel que le raccourci clavier,badgeoptionnel).- La vidéo obtient alors un beat avant la démonstration : l'icône repose sur un bureau calme parmi des fenêtres floutées, le curseur clique dessus, et la vraie fenêtre en sort, atterrissant exactement là où commence la démonstration.
- Il est composé dans Remotion (l'enregistreur ne capture que la fenêtre de l'application) et utilise
motifImage/motifcomme icône. Utilisez-le uniquement lorsque le code confirme le comportement.
5. Enregistrer + Rendre
npx tsx src/cli.ts <dépôt> --plan OUT/plan.json --from plan
Surveillez le journal : ✓ par action, ✗ avec l'erreur pour les échecs. En cas d'échec, lisez OUT/events.json → failures[] (chacun a l'instantané d'accessibilité au moment de l'échec), corrigez les cibles et relancez. Les actions échouées sont ignorées, pas fatales. Ne livrez pas une vidéo dont le bénéfice a échoué. Si une action précoce échoue, tout ce qui suit s'exécute généralement sur le mauvais écran : traitez tout l'enregistrement comme mauvais et regardez les trames de raw.mp4 pour voir ce qui s'est réellement passé.
Réexécution économique :
- Modifications du code de copie, d'aspect, de lanceur, de son ou de scène :
--from render, pas de réenregistrement. - Les sous-titres d'action sont intégrés dans
events.jsonau moment de l'enregistrement. Corrigez-les là à partir deplan.json(parindex), reconstruisez la timeline avecnpx tsx -e 'import {editRecording} from "./src/edit.ts"; editRecording("OUT")', puis--from render. - Modifications d'étape :
--from plan(réenregistre).
6. Vérifier avant de rapporter
Vérifiez le MP4 rendu, pas seulement les images fixes. Créez des planches contact et examinez chaque trame :
ffmpeg -v error -y -i OUT/demo.mp4 -vf "fps=1/2,scale=640:-1,tile=4x8" -frames:v 1 <brouillon>/sheet.jpg
Vérifiez :
- Correspondance de style : mettez
probe.pngà côté des images fixes. Même famille d'arrière-plan, polices, accent et mascotte ? Si la vidéo ressemble à une marque différente, corrigezlookavant toute autre chose. - Chaque valeur
fillapparaît à l'écran exactement comme tapée. Un ✓ signifie seulement que l'action a été exécutée, pas que le texte a atterri. - La caméra est zoomée sur ce qui compte (le texte tapé, le contrôle cliqué), pas en plan large ou sur un canevas vide.
- Les sous-titres sont lisibles et ne couvrent jamais l'application. Le texte tient ; rien ne déborde.
- La trame « aha » montre le bénéfice (pas un état de chargement ou un bouton recadré).
- Le beat de comparaison « X → Y » est crédible. Si le ratio est absurde, les
secondesde l'ancienne méthode sont gonflées. - L'audio existe et les pics sont en dessous de 0 dB :
ffmpeg -i OUT/demo.mp4 -af volumedetect -vn -f null -. Pour vérifier la synchronisation, dessinez unshowwavespicd'un passage de frappe et comparez-le avec les trames.
7. Rapporter
Donnez à l'utilisateur :
- le chemin vers
OUT/demo.mp4et sa durée - l'accroche, l'ancienne méthode et les lignes « seulement nous », une ligne chacune
- comment l'aspect a été adapté (quelles couleurs, polices et mascotte proviennent de l'application)
- tout ce que vous n'avez pas pu faire fonctionner, ou qui a été composé plutôt qu'enregistré (par exemple, le beat du lanceur)
- tous les bogues que vous avez remarqués dans son application (par exemple, des frappes perdues)
Mentionnez la commande npx remotion studio … que l'outil affiche pour les réglages en direct, et --music <fichier> pour une bande sonore.
Effets sonores
Activés par défaut ; --no-sfx les désactive. scripts/make-sfx.py synthétise tout (pas d'échantillons, pas de licence) dans assets/sfx/, et remotion/Sfx.tsx synchronise chaque son avec les événements enregistrés :
- Frappe : un son de commutateur mécanique tactile par caractère (clic de bosse, thock de fond, relâchement), à la vitesse de frappe réelle de l'enregistreur. Les espaces obtiennent un son stabilisé plus profond, Entrée un son plus lourd.
- Clics : un clic de souris là où le curseur enregistré a cliqué, y compris le clic du lanceur.
- Transitions : un whoosh à chaque changement de scène.
- Ancienne méthode : un son d'atterrissage de carte par étape (pop en mode doux, thud en mode gras) et un son de verdict (pop doux, ou tampon en mode gras).
- Bénéfice : un carillon.
- Comparaison : un pop par ligne, et un carillon (doux) ou tampon (gras) sur le résultat temporel.
Avec --music, la musique est abaissée sous les effets. Modifiez les volumes dans Sfx.tsx et relancez --from render. Relancez le script après l'avoir modifié pour régénérer les WAV.
Applications Mac natives
Même flux, enregistreur différent (mac/macdriver.swift : API d'accessibilité pour trouver les contrôles, événements réels de souris/clavier, ScreenCaptureKit enregistre uniquement la fenêtre de l'application). Ajoutez --app et passez les arguments de lancement après -- :
npx tsx src/cli.ts <dépôt ou ./dossier/local> --app chemin/Vers.app [--app-seed demo/items.json] --prepare -- --demo {data}
{data}devient un nouveau dossier jetable par exécution, et--app-seedy est copié. N'enregistrez jamais avec les vraies données de l'utilisateur. Si l'application n'a pas de drapeau de lancement de répertoire de données/démo, ajoutez-en un (ou demandez à l'utilisateur) avant d'enregistrer. Reconstruisez d'abord l'application si l'utilisateur a des modifications non validées.- Exécutez
mac/.build/macdriver check --opend'abord. Il nécessite les autorisations d'accessibilité et d'enregistrement d'écran et audio système pour l'application hébergeant le terminal. Si l'une ou l'autre manque, il ouvre le volet exact des Réglages Système et nomme l'application à activer (code de sortie 3). L'utilisateur doit redémarrer cette application après avoir accordé l'autorisation, ce qui met fin à cette session, arrêtez-vous et dites-lui de revenir plutôt que de réessayer. Sans enregistrement d'écran,--preparefonctionne toujours, mais pas l'enregistrement. Rédigez le storyboard entre-temps pour qu'il soit prêt. - L'enregistrement prend le contrôle de la souris et du clavier réels de l'utilisateur (~20–60s, compte à rebours de 3s). Prévenez l'utilisateur juste avant chaque exécution, y compris les courtes exécutions de test. Ne commencez pas pendant qu'il pourrait taper : sa saisie vole le focus et gâche la prise.
- Cibles :
id, puisplaceholder, puisrole+name. Pas degoto.fillsans cible tape dans le champ actif. Utilisezpresspour Entrée/Tab/Meta+N. - Les boutons d'icône sans étiquette sont invisibles pour l'automatisation. Si un contrôle clé n'a pas de nom et que vous possédez le code, ajoutez
.accessibilityLabel/.accessibilityIdentifier. - N'interrogez pas l'arbre d'accessibilité pendant que les touches sont tapées. Dans les applications SwiftUI, une requête AX peut déclencher un nouveau rendu qui réinitialise un champ de texte à un texte obsolète, supprimant les frappes. Le pilote ne lit l'élément focalisé qu'après la frappe. Si vous modifiez le pilote, conservez cette approche. Si les frappes disparaissent encore, l'application a probablement ce bogue (une vue de texte
NSViewRepresentabledontupdateNSViewécrase la chaîne avec une liaison obsolète). Informez l'utilisateur.
Limites
Les pages web derrière une connexion nécessitent que le flux commence à partir d'une page publique ou d'une URL pré-authentifiée. L'enregistrement natif est uniquement macOS et enregistre une seule fenêtre d'application. Tout ce qui se trouve à l'extérieur (bureau, barre de menus, autres applications) est composé dans Remotion, pas enregistré, donc mentionnez-le dans le rapport.