Communitygithub.com

storyboard-interactif

Transformez un storyboard terminé en une **histoire visuelle interactive** : une page web où le spectateur avance dans l'histoire en cliquant, en maintenant et en faisant glisser les dessins eux-mêmes, avec du son, des sous-titres/dialogues et des transitions qui respectent le rythme du film.

Qu'est-ce que storyboard-interactif ?

Ce skill permet de convertir un storyboard finalisé (PDF ou images) en une expérience narrative interactive sur une seule page HTML. L'utilisateur interagit directement avec les dessins via des gestes (clic, pression, glisser) plutôt qu'avec des boutons génériques, ce qui rend chaque action narrative (courir, retenir son souffle, grimper, tourner une page) naturelle et immersive. Le skill prend en charge le son (enregistré ou synthétisé via WebAudio), les dialogues sous forme de bulles ou sous-titres, les transitions respectueuses du rythme du film, et une commutation de langue en direct. Il est conçu pour les personnes qui connaissent déjà le storyboard (planches, plans, slugs, notes) et ne génère pas d'animatique. L'auteur, Ding Yilin, fournit des exemples concrets : *La Joie de la Chambre Blanche* et *Fahrenheit 451* (scènes 1, 8, 9) qui peuvent être joués en direct. La construction se fait en un seul tour de questions pour les options clés (scènes, look, texte, son, langues, hébergement, crédits), le reste étant pris en charge par des valeurs par défaut raisonnables. Le résultat est une page web autonome, prête à être partagée ou intégrée dans le site de l'utilisateur, avec des assets organisés et une structure de code robuste (machine à états, gestion des gestes, performance optimisée).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/beiabei10/interactive-storyboard/tree/HEAD/interactive-storyboard

Demander à votre IA préférée

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

Documentation

Storyboard interactif

Transformez un storyboard terminé en une histoire visuelle interactive : une page web où le spectateur avance dans l'histoire en cliquant, en maintenant et en faisant glisser les dessins eux-mêmes, avec du son, des sous-titres/dialogues et des transitions qui respectent le rythme du film. Ce skill est destiné aux personnes qui savent déjà ce qu'est un storyboard (planches, plans, slugs, notes) ; ce n'est pas un générateur d'animatique.

Exemples créés par l'auteur de ce skill, Ding Yilin : La Joie de la Chambre Blanche et Fahrenheit 451 (scènes 1, 8, 9) — voir examples/ ; jouez-les en direct : La Joie de la Chambre Blanche, Fahrenheit 451, scènes 1 → 8 → 9.

0. Demander avant de construire (un tour, puis c'est parti)

Ne demandez que ce qui change la construction ; prenez des valeurs par défaut sensées pour le reste et dites lesquelles.

  1. Quelles scènes / planches (un long storyboard : pilotez d'abord une scène, puis faites les autres de la même manière).
  2. Look : l'un des préréglages ci-dessous, ou "garder mes dessins tels quels".
  3. Texte : dialogues seulement / narration / les deux / aucun. Utilisez les répliques du storyboard ; n'inventez jamais de dialogues ou de narration.
  4. Son : les enregistrements de l'utilisateur (demandez les fichiers et à quelle planche chacun appartient) ou son synthétisé.
  5. Langues : demandez toujours quelles langues le projet nécessite ; il n'y a pas de jeu par défaut. Construisez uniquement celles-ci. Chaque chaîne à l'écran (titres, slugs, indices, bulles, crédits) vit dans une table par langue et est commutable en direct ; avec plus d'une langue, la langue de départ peut suivre une page hôte (?lang=, un postMessage, ou <html lang>). Les traductions que vous faites sont des brouillons que l'utilisateur doit vérifier.
  6. Où cela vivra : une page partageable uniquement, ou également intégrée dans le site web de l'utilisateur (demandez alors le package du site et modifiez leur copie).
  7. Ligne de crédit : utilisez exactement le libellé que l'utilisateur donne (par exemple "Créé par …") ; n'ajoutez pas de rôles qu'il n'a pas listés.

1. Lire le storyboard

  • Storyboarder / exports PDF : pdfimages -png donne chaque planche en taille réelle, y compris la zone NOTE ; trouvez le cadre du dessin une fois (parcourez les lignes/colonnes pour les traits de cadre) et recadrez chaque planche de la même manière sur la zone de dessin (gardez une fenêtre 16:9 si la scène est en 16:9). Rendez les pages avec pdftoppm -r 150 et lisez les notes, slugs (EXT./INT. … – JOUR/NUIT), durées et dialogues ; pdftotext -layout récupère les slugs.
  • Créez une planche contact et une vue quadrillée (lignes tous les 0,1 de largeur/hauteur) de chaque planche : chaque coordonnée ultérieure (où se tient un personnage, où taper, où se trouve un écran) est mesurée sur celles-ci, en fractions d'image, jamais devinée.
  • Écrivez une liste de beats : planche → ce qui se passe → le geste qui ferait faire cette action au spectateur → son → texte.

2. Plans avant les effets

  • Trouvez les plans longs. Des planches consécutives avec le même décor et des sujets en mouvement (A→B→C de personnes qui marchent) forment un seul plan continu : construisez un arrière-plan propre (supprimez le sujet à l'aide des autres planches), découpez le sujet et déplacez-le, avec la caméra qui le suit. Ne faites pas de fondu enchaîné de planches entières ici.
  • Plan serré → plan large des mêmes sujets (ou l'inverse) est un seul mouvement : cadrez la planche large zoomée de sorte que ses sujets aient la même taille et position que dans le plan serré (calculez le zoom et le centre à partir des positions mesurées de la tête/des pieds), terminez le fondu enchaîné à ce cadrage correspondant, puis reculez. Vérifiez l'image correspondante dans une capture d'écran ; des fantômes signifient que les chiffres sont faux.
  • Les planches qui doivent se lire comme un seul mouvement partagent une palette (traitez-les avec la même couleur de préréglage).
  • Lorsque l'utilisateur dit qu'une planche montre l'arrière d'une télé, une porte vue de dos, etc., ne dessinez rien que la planche ne montre pas : la lumière et le son peuvent suggérer ce qui est hors champ.

3. Préréglages de look

Tous les préréglages conservent le dessin au trait de l'utilisateur ; ils ne le redessinent jamais.

  • Film / riso (le look de la Chambre Blanche) : gradation par scène (couleur saturée vive sur fond sombre), texture de papier douce, grain léger ; occasionnellement — pas constamment — tangage de porte, scintillement et légères rayures ; une ombre d'enregistrement. Les effets sont rares et discrets : un scintillement ou un tremblement constant est fatigant.
  • Comics américain : lissage bilatéral ; une couche d'encre à partir d'un seuil sombre plus un chapeau noir pour que les traits de crayon fins soient encrés ; une couleur plane de tache dans les zones dessinées, des points Ben-Day à 45° dans les tons moyens et un écran léger sur tout le panneau, plus dense sur les bords ; le calque couleur décalé de 1–2 px par rapport au calque d'encre ; sortie ~1,5×. Une couleur de tache par lieu/temps (jour chaud, nuit bleue, CCTV verte, alarme rouge…). Lettrage : boîtes de légende jaunes pour les slugs, mots SFX de BD dans l'image, bulles de dialogue.
  • Pixel : réduire la taille à une petite grille avec une palette limitée et un tramage ordonné, agrandir au plus proche voisin ; texte dans une police pixel.

Le chrome de la page suit le préréglage (salle de projection, page de journal, écran de jeu). Les polices web se chargent avec une course de secours de 2–3 s pour que l'histoire ne les attende jamais.

4. Construction : une page HTML, un canvas

  • Une scène 16:9, un canvas, une zone de sous-titres/indices en dessous, un sélecteur de langue (si plus d'une langue) et une bascule son.
  • Machine à états de scène : chaque scène est un objet avec enter / render(t) / tap / drag / down / up / hover / key ; go(scene) bascule ; st() est le temps dans la scène. Un assistant de caméra (setCam(img, zoom, cx, cy), toScreen, toImg) pour que chaque zone d'interaction et effet soit placé en fractions d'image et suive la caméra.
  • Chaque scène a une sortie : une touche clavier et une temporisation automatique lente (10–20 s) pour que personne ne reste bloqué, plus un lien "passer" sur les longues.
  • Enveloppez chaque appel sonore pour qu'un contexte audio manquant ou un décodage échoué ne puisse jamais casser l'histoire.
  • Chargez les images avec <img> (fonctionne aussi sur file://) ; l'audio via fetch + decodeAudioData, avec repli sur des éléments <audio> lorsque fetch est bloqué.

5. Conception d'interaction

  • Le geste est l'action de l'histoire. Courir = clics rapides ; retenir son souffle = ne pas toucher ; se pencher pour regarder = maintenir ; grimper = glisser vers le haut à plusieurs reprises ; passer quelque chose = le porter ; tourner une page = glisser à travers le livre ; l'éteindre = maintenir la main sur le bouton. Préférez ces gestes aux "cliquer pour continuer" génériques ; gardez les simples tapotements pour les dialogues et les beats purement rythmiques.
  • Utilisez le dessin de l'utilisateur, jamais un accessoire inventé. Découpez le personnage/objet le long de son contour (polygone tracé sur le zoom quadrillé, bord doux), ajoutez une fine bordure blanche comme un découpage en papier, soulevez-le avec une petite ombre et inclinaison pendant le glissement, laissez le papier nu à son emplacement d'origine, rattachez-le si mal déposé. Vérifiez la découpe par rapport à la planche : n'incluez pas d'escalier, de meuble ou de main d'un autre personnage par erreur.
  • Les effets ajoutés sur une planche (un écran qui s'allume, des ondes radio, un viseur) doivent suivre la géométrie du dessin — découpez une lueur d'écran selon le quadrilatère en perspective de l'écran, pas un rectangle — et doivent être signalés à l'utilisateur comme des ajouts.
  • Les indices disent où et comment : "Maintenez le poisson et frottez d'avant en arrière", pas "interagissez". Plus grands que le texte du corps, sous l'image.
  • Guides sur l'image, discrets par défaut (pensez à What Remains of Edith Finch) : un petit signe sur le point de contact qui indique déjà l'action — une impulsion pour un tapotement, un anneau qui se remplit pour un maintien, des chevrons qui coulent dans la direction du glissement, un arc tournant pour un cercle (dans le style comics : des coches "regarde ici" à l'encre). Une main démontre le geste deux fois au début de l'étape, puis recule ; elle ne revient qu'après ~3 s d'hésitation. Cachez tout lorsque le doigt est enfoncé. Ne couvrez jamais l'image avec de longs chemins pointillés.

6. Transitions

  • Accordez le ton : doux par défaut (fondus où le nouveau panneau se pose en venant d'un peu plus grand, encrage/désencrage, une légère lueur pour l'allumage d'une télé ou le début d'un feu). Gardez un seul cut franc (image négative, lignes de vitesse, secousse) pour le choc unique de la scène. Tous les cuts francs = rigides.
  • Une poussée continue vers l'espace suivant est un long mouvement : tout ce qui se trouve entre (un mur) prend la couleur et la texture du panneau de destination et y fond ; pas de gouttières au milieu d'un mouvement.
  • Ne montrez jamais les bords noirs d'une image pivotée ou zoomée : bloquez la caméra.

7. Son

  • Son enregistré : coupez à l'action (une porte qui s'ouvre synchronisée avec la poignée dessinée), nivelez le tout, bouclez les ambiances avec des fondus.
  • Son synthétisé (WebAudio, pas de fichiers) : pas, papier, portes, chiens mécaniques, alarmes, battements de cœur, murmure de télé… Randomisez chaque coup (timing, hauteur, enveloppe) et façonnez les enveloppes de manière inégale pour que rien ne semble répété par une machine ; évitez les clics et les bips secs dans les scènes calmes.
  • Utilisez des ponts sonores pour le sens (une machine à laver devenant lentement la mer du rêve ; un son continuant sur le titre). Demandez avant d'ajouter des sons que le storyboard n'implique pas.

8. Texte

  • Dialogues : bulles de parole (comics) ou sous-titres (film), la queue pointant vers la tête du locuteur, maintenue à l'intérieur du panneau, enveloppée en mesurant, ne commençant jamais une ligne par une ponctuation fermante. Remplissez le corps et la queue de chaque bulle séparément pour qu'aucun trait ne traverse le texte.
  • Slugs comme boîtes de légende dans le coin ; gardez-les hors du dessin important (sautez la légende sur une planche où elle couvrirait le sujet).
  • Les citations que vous ajoutez (par exemple ce que récitent les personnages) doivent être dans le domaine public et signalées à l'utilisateur.

9. Performances

  • Limitez le canvas à ~1600 px de large (DPR = max(1, min(devicePixelRatio, 2, 1600 / cssWidth))).
  • Pré-rendez les superpositions statiques (texture de papier, vignette) une fois par taille et appliquez-les sur chaque image ; ne reconstruisez jamais de dégradés ou de motifs par image.
  • Pour les fondus, gardez l'image précédente à moitié taille, pas une copie complète à chaque image.
  • Chargez paresseusement l'histoire sur la page hôte (affiche + bouton "Entrer dans l'histoire") ; chaque page de scène charge uniquement ses propres images.

10. Testez comme un spectateur

  • Une exécution en navigateur sans tête (par exemple Playwright) avec de vrais gestes de souris (clics, maintiens, glissements mesurés depuis toScreen) à travers toute l'histoire, dans chaque langue, en échouant sur toute erreur de page. Exposez un test-only __go(scene, state) pour sauter à un beat.
  • Captures d'écran de chaque image clé et du milieu de chaque transition/correspondance ; regardez-les.
  • Vérifiez la syntaxe du script après les modifications (node --check). Ne mettez pas de commentaires // au milieu d'une instruction sur une seule ligne (cela commente silencieusement le reste de la ligne et la page reste blanche).
  • Mesurez le taux d'images avant/après les changements lourds. Dites clairement que le son et la sensation ont été vérifiés par des mesures et des captures d'écran, pas en jouant.

11. Livraison

  • Une page hébergée partageable pour révision ; pour le site web de l'utilisateur, un zip de son package de site avec l'histoire dans son propre dossier (par exemple story/<project>/), un bloc d'intégration à chargement paresseux, et rien d'autre de modifié. Si l'utilisateur a adapté l'histoire dans son site, modifiez toujours cette copie (fusion à 3 voies de vos modifications sur celle-ci), ne l'écrasez jamais avec l'originale.
  • Plusieurs scènes : une page par scène partageant un dossier d'assets, chaînées (fin de scène → scène suivante, langue conservée ; la dernière revient à la première). La couverture de chaque scène nécessite un clic pour déverrouiller l'audio après la navigation.
  • Ne déployez jamais nulle part au nom de l'utilisateur ; remettez le zip.
  • Un fichier ouvert seul sera noir : la page a besoin de son dossier d'assets a/ à côté. Dites-le lors de la remise des fichiers.

Skills associés