Écrire avec un agent
Un agent de code écrit une présentation Vignettes depuis le dépôt de votre produit, où il lit le code, la documentation et les stories. Il écrit un fichier .md, que vous importez dans le studio.
La skill writing-decks contient les règles du format, au format ouvert Agent Skills : l'en-tête, le découpage, les annotations, les composants et les stories Storybook. Claude Code, Codex, GitHub Copilot, Cursor et les autres agents qui lisent ce format la chargent quand une demande nomme une présentation Vignettes.
Installer la skill
La skill est dans le dépôt privé ShallowRed/vignettes, que votre compte GitHub doit pouvoir lire.
Dans Claude Code, le dépôt est une marketplace de plugins. Votre ordinateur doit pouvoir le cloner sans saisie de mot de passe : par une connexion gh auth login, ou par une clé SSH sans phrase de passe. Dans une session :
/plugin marketplace add ShallowRed/vignettes
/plugin install vignettes-decks@vignettes
Choisissez « Install for you (user scope) » pour l'utiliser dans tous vos projets. La commande /vignettes-decks:writing-decks apparaît ensuite dans la liste ouverte par /.
Pour les autres agents, la commande gh skill install de GitHub CLI, en préversion, place la skill dans le dossier que lit votre agent, nommé par --agent : codex, github-copilot, cursor, gemini-cli, ou un autre de la liste de gh skill install --help.
gh skill install ShallowRed/vignettes writing-decks --agent codex --scope user
Avec --scope user, la skill vaut pour tous vos projets ; avec --scope project, elle est installée dans le dépôt courant, et votre équipe la reçoit avec le dépôt. gh skill update installe la dernière version.
Faire écrire la présentation
Ouvrez votre agent dans le dépôt de votre produit et demandez la présentation en nommant Vignettes :
Écris une présentation Vignettes de six diapositives pour la revue de sprint, dans docs/presentations/revue-de-sprint.md.
Pour être sûr que l'agent charge la skill, demandez-lui d'utiliser la skill writing-decks, ou, dans Claude Code, commencez la demande par /vignettes-decks:writing-decks. Pour des écrans de votre Storybook, donnez-lui l'adresse du Storybook et le nom des composants (Intégrer une story).
Importer le fichier
Dans le catalogue, cliquez sur « Nouvelle présentation », choisissez le point de départ « Fichier Markdown », puis déposez le fichier. Le titre et le thème viennent de l'en-tête du fichier, qui doit contenir la clé title. Si une clé a une valeur refusée, le message nomme la clé : corrigez le fichier, puis choisissez-le de nouveau.
La présentation créée est privée, et indépendante du fichier. Relisez-la dans l'aperçu, puis publiez-la.
Faire modifier une présentation
- Téléchargez son texte et placez le fichier dans votre projet.
- Demandez la modification à l'agent.
- Dans l'éditeur, remplacez tout le texte par celui du fichier modifié, puis publiez. La version précédente reste dans l'historique.
Pour garder la présentation d'origine, importez le fichier modifié comme une nouvelle présentation.