Communitygithub.com

visuel-story

Narration visuelle pour montrer des choses complexes aux gens : un film explicatif animé sur un grand canevas avec caméra, scènes et légendes ; une carte interactive d'un processus ou système ; un pitch deck avec micro-animations, transitions et un PDF statique ; leurs versions téléphone, export MP4 image par image, publication sur un sous-domaine et un QR code.

Qu'est-ce que visuel-story ?

Ce skill permet aux agents IA (Claude Code, Cursor, etc.) de créer des supports visuels narratifs sophistiqués : films explicatifs animés sur un grand canevas avec système de caméra et légendes, cartes interactives de processus ou systèmes, et pitch decks avec micro-animations et transitions. Il guide l'agent à travers un workflow structuré : définition de l'objectif avec l'utilisateur, rédaction d'un script sous forme de tableau, réalisation d'un pilote (une scène complète pour valider le style), puis production par lots de 2-3 scènes. Le skill inclut des runbooks spécialisés pour l'export vidéo MP4, les versions responsives (téléphone/tablette), la publication avec sous-domaine et QR code, ainsi que des règles de goût et de vérification qualité. Il évite les erreurs courantes comme tout construire avant de montrer, faire des éléments trop petits, ou utiliser du texte de remplissage inutile. Il offre également une aide à la décision pour distinguer entre un film (histoire séquentielle avec présentateur) et une carte (vue d'ensemble exploratoire).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/smixs/visual-story/tree/HEAD

Demander à votre IA préférée

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

Documentation

Visuel story

Présenter des choses complexes sous forme d'images : scène par scène, en grand, avec un mouvement qui explique plutôt qu'il ne décore. La légende dit ce qui se passe ; le canevas le montre. Chaque lot de travail se termine par une image montrée à l'utilisateur et son « oui ».

Ce que vous fabriquez → quel runbook ouvrir

TâcheRunbook
Film explicatif : scènes sur un canevas, caméra, légendes, carte « schéma complet »references/motion-film.md
Carte interactive d'un processus ou système avec sauts entre nœudsreferences/scheme.md
Pitch deck avec micro-animations, transitions et un PDFreferences/deck.md
Conférence simple sans scènes ni camérautilisez un workflow de diaporama classique ; empruntez les règles de lisibilité de deck.md
Exporter un film ou une carte en MP4references/video-export.md
Versions téléphone et tablettereferences/responsive.md
Publication, sous-domaine, mot de passe, QRreferences/publish.md
Vérification visuelle : images par URL, planches contact, checklistreferences/qa.md
Règles de goût : couleur, typographie, mouvement, densitéreferences/taste.md
Œuvres de référence pour copier un squelettereferences/examples.md

Ouvrez taste.md, examples.md et le runbook correspondant avant la première ligne de code. Ouvrez qa.md avant la première présentation.

Film ou carte ? Un film est une histoire qui se déroule dans le temps, où un présentateur guide le spectateur scène par scène. Une carte est une grande image que le spectateur explore seul. « Animer notre processus pour un webinaire » est un film ; « une carte du système pour regarder autour » est une carte. En cas de doute, posez une question.

Ordre de travail pour chaque type

  1. Objectif dans les mots de l'utilisateur, puis questions. Posez en un seul lot, l'option recommandée en premier, et seulement ce qui n'est pas encore répondu : quelle référence (« comme la dernière fois »), comment c'est présenté (clic du présentateur / lecture automatique / vidéo / PDF), le style (le site web du produit), la langue, les données (fictives ou la source de l'utilisateur), la date limite et l'écran.
  2. Script sous forme de tableau — scènes ou diapositives : numéro, titre, une ligne de sens. Attendez le « oui ».
  3. Pilote. Une scène ou une ou deux diapositives, entièrement terminées : image, mouvement, légendes. Images → montrer → attendre le « oui ». Pourquoi : un style trouvé dans le pilote se reporte sur tout le reste ; un style trouvé à la scène douze signifie refaire douze scènes.
  4. Lots de 2 à 3 scènes ou diapositives ; montrez chaque lot et attendez.
  5. Assembler le tout : navigation, carte du schéma complet ou vue d'ensemble, mises en page téléphone, publication, QR, PDF ou vidéo — tout ce qui a été commandé.

Date limite sous un jour : un pilote et un « oui », le reste en un seul lot ; vérifiez les images uniquement aux tailles où elles seront présentées (l'écran de diffusion, plus les téléphones si les spectateurs reçoivent un lien).

Avant de dire « terminé »

  • Les images aux tailles d'affichage de qa.md sont prises et examinées ; les défauts corrigés en un seul lot.
  • Si la publication a été commandée : l'adresse en ligne sert la nouvelle version (?v=NN), et zbarimg lit le QR.
  • Si un PDF ou une vidéo a été commandé : le fichier est ouvert et examiné page par page ou image par image.
  • L'utilisateur a vu le résultat et répondu.
  • Vos propres captures d'écran, sessions navigateur et processus serveur sont nettoyés (arrêtez les serveurs par leur pid).

Erreurs courantes

  • Tout construire et le montrer à la fin → l'utilisateur change le style et vous refaites tout. Travaillez par lots.
  • Faire les choses petites : dix petites étiquettes sur le canevas au lieu d'une grande idée. Image grande, code petit.
  • Hésiter avec du texte : « Scannez avec votre téléphone » sous un QR, « encore en développement », « vous pouvez… », indices de gestes. Ce qui est clair sans mots reste sans mots.
  • Décorer : bandes d'accent colorées sur les bords des cartes, clignotements, « juste joli ». Le mouvement explique une transition ou il n'existe pas.
  • Un nombre sans nom et moment (« 8 cartes ») → le spectateur ne sait pas ce qu'il regarde.
  • Vérifier « en lisant le code » sans image à la bonne taille → sur un téléphone tout s'effondre.

Skills associés