Communitygithub.com

Zimzheng/prompt-to-canvas

Compétence d'agent permettant de transformer du contenu en canevas Excalidraw élégants et modifiables.

Qu'est-ce que prompt-to-canvas ?

Prompt to Canvas est une compétence de conception conçue pour les agents IA comme Claude Code ou Cursor, qui permet de créer des canevas Excalidraw polis et entièrement modifiables à partir de contenu utilisateur. L'agent compose la mise en page, sélectionne un style visuel dans un catalogue, génère un diagramme SVG, le convertit en scène JSON Excalidraw, puis l'ouvre dans un éditeur local. Contrairement à un simple générateur de graphiques ou un remplisseur de modèles, cette compétence laisse l'agent décider de la thèse, de la structure, de la hiérarchie et des connexions, en utilisant le style uniquement pour la palette et l'ambiance. Elle est particulièrement utile pour créer des infographies, diagrammes d'architecture, frises chronologiques, tableaux de bord, cartes conceptuelles et présentations visuelles. La compétence applique des règles strictes : le fond du canevas infini reste blanc, la langue d'interaction de l'utilisateur est utilisée pour les textes visibles, et les termes techniques ou noms de produit restent dans leur langue d'origine si nécessaire. L'ensemble du processus est automatisé via des scripts Node.js (validation de scène, conversion SVG vers Excalidraw, ouverture d'éditeur) et vérifié par des tests de fumée.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add Zimzheng/prompt-to-canvas

Demander à votre IA préférée

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

Documentation

Prompt to Canvas

Compétence de système de conception pour créer des canevas Excalidraw élégants et modifiables à partir de contenu fourni par l'utilisateur. L'agent compose la mise en page, utilise le catalogue de styles intégré pour la direction visuelle, construit une source SVG, la convertit en JSON de scène Excalidraw modifiable, et l'ouvre dans l'éditeur local.

Ce n'est pas un générateur automatique de graphiques ou un remplisseur de modèles. Le style donne la palette et l'ambiance ; l'agent décide de la thèse, de la structure, du groupement, de la hiérarchie, des étiquettes et des connecteurs.

Utilisez la langue d'interaction principale de l'utilisateur pour le texte visible du canevas, les titres, les étiquettes de sections, les annotations et les légendes, sauf si l'utilisateur demande explicitement une autre langue. Conservez les termes techniques, noms de produits, noms d'API, acronymes, identifiants de code, métriques et phrases source entre guillemets dans leur langue d'origine lorsque c'est plus clair.

Quand l'utiliser

  • L'utilisateur souhaite un canevas modifiable, une infographie, un diagramme, un graphique d'architecture, une frise chronologique, une comparaison, un tableau de bord, une carte conceptuelle ou un visuel prêt pour une présentation.
  • L'utilisateur fournit du contenu et demande de « dessiner », « visualiser », « transformer ceci en canevas », « créer un tableau de bord », ou nomme cette compétence.
  • Le résultat doit être soigné, modifiable, exportable et stylisé visuellement.

Étape 0 : prérequis

Exécutez scripts/preflight.sh ou vérifiez manuellement :

  • Node 20 ou plus récent.
  • assets/editor/index.html existe.
  • scripts/svg-to-scene.mjs, scripts/validate-scene.mjs et scripts/open-editor.mjs existent.
  • CATALOG.md, RULES.md, templates/ et assets/styles/ existent.

Si quelque chose manque, dites à l'utilisateur ce qui manque et arrêtez.

Comment dérouler la conversation

  1. Comprendre le canevas. Identifiez le contenu, le but et le public. Si ce n'est pas assez clair pour modifier le tableau, posez une question courte avant de construire.
    • Lorsque l'hôte prend en charge des choix structurés ou sélectionnables, utilisez-les. Sinon, posez une question texte concise.
    • Proposez 2 à 3 options déduites, placez l'option recommandée en premier, et incluez une option « l'agent choisit » dans la langue de l'utilisateur lorsque le prompt a déjà assez de contexte.
  2. Demander l'ambiance. Demandez le style visuel : sobre, professionnel, ludique, audacieux, de marque, préférence de couleur ou humeur. Proposez de choisir si l'utilisateur n'a pas de préférence. Ignorez cette étape si l'utilisateur a déjà nommé un style ou une ambiance claire.
    • Utilisez des options sélectionnables lorsque l'hôte les prend en charge.
    • Mappez les options aux niveaux du catalogue : Restreint, Équilibré ou Audacieux.
  3. Choisir un style. Utilisez CATALOG.md pour choisir un style. Choisissez uniquement dans le tableau du catalogue ; ne comparez pas plusieurs fichiers design.md. Dites à l'utilisateur le style choisi et pourquoi en une ligne.
  4. Construire. Lisez RULES.md, rules/canvas-rules.md, rules/visualization-strategy.md, et uniquement le fichier templates/<slug>/design.md sélectionné, puis :
    • Utilisez rules/analysis-prompt.md comme checklist éditorial privé : déterminez le public, le travail de l'artefact, la thèse centrale, les entités clés, les relations, les compromis, et 3 à 6 affirmations qui méritent une place sur le canevas.
    • Faites correspondre le texte visible du canevas, les titres, les étiquettes de section, les annotations et les légendes à la langue d'interaction principale de l'utilisateur, sauf demande contraire. Les termes techniques, noms de produits, noms d'API, acronymes, identifiants de code, métriques et phrases source entre guillemets peuvent rester dans leur langue d'origine lorsque c'est plus clair.
    • Composez d'abord diagram.svg dans un espace logique d'environ 1600-1700 px de large. Utilisez les formes SVG natives : rect, circle, ellipse, line, polyline et text. Conservez chaque étiquette visible sous forme de texte.
    • Gardez le fond du canevas infini Excalidraw blanc. Si le style choisi a un fond/arrière-plan coloré, dessinez-le comme un rectangle modifiable à l'intérieur de la scène ; ne mettez jamais cette couleur dans appState.viewBackgroundColor.
    • Gardez la sélection de style indépendante du fond du canevas Excalidraw. Choisissez en fonction du contenu, du public, de la formalité et de l'ambiance ; la couleur du fond/papier du modèle reste une partie de l'artefact visuel en tant que rectangle modifiable à l'intérieur de la scène.
    • Mettez uniquement le contenu de l'artefact final sur le canevas. Le contexte concernant les invites, les sources, les chemins de fichiers, le style choisi ou le processus appartient à la réponse du chat.
    • Appliquez le style sélectionné comme un système visuel : palette, densité, trait, traitement des coins, hiérarchie, discipline des accents et ambiance de la mise en page.
    • Convertissez le SVG en JSON de scène Excalidraw modifiable :
node scripts/svg-to-scene.mjs --svg diagram.svg --out scene.json
  • Validez la scène :
node scripts/validate-scene.mjs --scene scene.json
 Lorsqu'une attente claire de langue/script existe, validez-la aussi :
node scripts/validate-scene.mjs --scene scene.json --expected-language <code-langue>
  • Inspectez l'éditeur ouvert ou l'export rendu. Corrigez le texte tronqué, l'espacement serré, la hiérarchie faible, les chevauchements accidentels, le texte d'exemple obsolète et les dérives de style. Préférez corriger diagram.svg et reconvertir ; utilisez les modifications du JSON de scène uniquement pour un nettoyage spécifique à Excalidraw.
  1. Ouvrir l'éditeur. Utilisez :
node scripts/open-editor.mjs --scene scene.json

Chaque appel démarre une URL d'éditeur locale indépendante. Faites cela pour chaque nouveau canevas, modèle alternatif ou version régénérée au lieu de réutiliser une ancienne URL. Par défaut, le script avance vers un port disponible vierge et sert la scène à partir d'une URL unique sans cache. Un port est libéré lorsque ce processus open-editor.mjs est arrêté ou que la session hôte se termine.

  1. Livrer. Donnez à l'utilisateur l'URL locale imprimée. Mentionnez que l'éditeur prend en charge le changement d'interface utilisateur chinois/anglais, la sauvegarde automatique locale à l'épreuve des rafraîchissements, et l'export PNG/SVG. Proposez de restituer le même contenu dans un autre style.

Fichiers

Test de fumée

scripts/preflight.sh
node scripts/svg-to-scene.mjs --svg test-diagram.svg --out test-scene.json
node scripts/validate-scene.mjs --scene test-scene.json
node scripts/open-editor.mjs --scene test-scene.json --no-open

Skills associés