Communitygithub.com

Zimzheng/prompt-to-canvas

Habilidad de agente para convertir contenido en lienzos Excalidraw editables y pulidos.

¿Qué es prompt-to-canvas?

Este skill permite a un agente de IA transformar contenido textual o datos en lienzos visuales editables con Excalidraw, ideales para diagramas, infografías, dashboards o gráficos de arquitectura. A diferencia de generadores automáticos de gráficos, este skill otorga al agente control total sobre la tesis, estructura, jerarquía y estilo visual, seleccionando una paleta de un catálogo integrado y componiendo manualmente el layout en SVG. El proceso incluye la validación del esquema, la conversión a JSON de escena Excalidraw y la apertura en un editor local. Está diseñado para asistentes como Claude Code, Cursor o Codex que ejecuten scripts Node.js, y requiere Node 20 o superior, así como varios archivos de configuración y reglas. El resultado final es un lienzo pulido, editable y exportable, listo para presentación o iteración posterior.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Prompt to Canvas

Habilidad de sistema de diseño para crear lienzos Excalidraw editables y pulidos a partir de contenido proporcionado por el usuario. El agente compone la disposición, utiliza el catálogo de estilos incluido para la dirección visual, construye una fuente SVG, la convierte en JSON de escena Excalidraw editable y la abre en el editor local.

Esto no es un generador automático de gráficos ni un rellenador de plantillas. El estilo proporciona paleta y ambiente; el agente decide la tesis, estructura, agrupación, jerarquía, etiquetas y conectores.

Utiliza el idioma principal de interacción del usuario para el texto visible en el lienzo, encabezados, etiquetas de sección, anotaciones y pies de ilustración, a menos que el usuario solicite explícitamente otro idioma. Mantén los términos técnicos, nombres de productos, nombres de API, acrónimos, identificadores de código, métricas y frases fuente entrecomilladas en su idioma original cuando sea más claro.

Cuándo usarlo

  • El usuario quiere un lienzo editable, infografía, diagrama, gráfico de arquitectura, línea de tiempo, comparación, panel de control, mapa conceptual o gráfico listo para presentación.
  • El usuario proporciona contenido y pide "dibujar", "visualizar", "convertir esto en un lienzo", "hacer un tablero de portafolio" o nombra esta habilidad.
  • El resultado debe ser pulido, editable, exportable y visualmente estilizado.

Paso 0: requisitos previos

Ejecuta scripts/preflight.sh o verifica manualmente:

  • Node 20 o más reciente.
  • assets/editor/index.html existe.
  • scripts/svg-to-scene.mjs, scripts/validate-scene.mjs y scripts/open-editor.mjs existen.
  • CATALOG.md, RULES.md, templates/ y assets/styles/ existen.

Si falta algo, indícale al usuario qué falta y detente.

Cómo ejecutar la conversación

  1. Comprender el lienzo. Identifica el contenido, propósito y audiencia. Si no está lo suficientemente claro como para cambiar el tablero, haz una pregunta breve antes de construir.
    • Cuando el anfitrión soporte opciones estructuradas o seleccionables, úsalas. De lo contrario, haz una pregunta de texto compacta.
    • Ofrece 2-3 opciones inferidas, coloca la opción recomendada primero e incluye una opción "el agente elige" en el idioma del usuario cuando el mensaje ya tenga suficiente contexto.
  2. Preguntar por el ambiente. Pregunta por el estilo visual: tranquilo, profesional, divertido, audaz, similar a una marca, preferencia de color o ambiente. Ofrece elegir si el usuario no tiene preferencia. Omite esto si el usuario ya nombró un estilo o ambiente claro.
    • Usa opciones seleccionables cuando el anfitrión las soporte.
    • Mapea las opciones a los niveles del catálogo: Restrained, Balanced o Bold.
  3. Elegir un estilo. Usa CATALOG.md para elegir un estilo. Elige solo de la tabla del catálogo; no compares varios archivos design.md. Indica al usuario el estilo elegido y el porqué en una línea.
  4. Construirlo. Lee RULES.md, rules/canvas-rules.md, rules/visualization-strategy.md y solo el templates/<slug>/design.md seleccionado, luego:
    • Usa rules/analysis-prompt.md como lista de verificación editorial privada: decide la audiencia, el trabajo del artefacto, la tesis central, las entidades clave, las relaciones, las compensaciones y 3-6 afirmaciones que merezcan espacio en el lienzo.
    • Iguala el texto visible del lienzo, encabezados, etiquetas de sección, anotaciones y pies de ilustración al idioma principal de interacción del usuario a menos que el usuario pida otra cosa. Los términos técnicos, nombres de productos, nombres de API, acrónimos, identificadores de código, métricas y frases fuente entrecomilladas pueden permanecer en su idioma original cuando sea más claro.
    • Compón primero diagram.svg en un espacio lógico de aproximadamente 1600-1700 px de ancho. Usa formas SVG nativas: rect, circle, ellipse, line, polyline y text. Mantén cada etiqueta visible como texto.
    • Mantén el fondo del lienzo infinito de Excalidraw en blanco. Si el estilo elegido tiene un fondo/papel de color, dibújalo como un rectángulo editable dentro de la escena; nunca pongas ese color en appState.viewBackgroundColor.
    • Mantén la selección de estilo independiente del fondo del lienzo de Excalidraw. Elige por contenido, audiencia, formalidad y ambiente; el color de papel/fondo de la plantilla sigue siendo parte del artefacto visual como un rectángulo editable dentro de la escena.
    • Coloca solo el contenido del artefacto terminado en el lienzo. El contexto sobre mensajes, fuentes, rutas de archivos, estilo elegido o proceso pertenece a la respuesta del chat.
    • Aplica el estilo seleccionado como un sistema visual: paleta, densidad, trazo, tratamiento de esquinas, jerarquía, disciplina de acento y ambiente de disposición.
    • Convierte el SVG en JSON de escena Excalidraw editable:
node scripts/svg-to-scene.mjs --svg diagram.svg --out scene.json
  • Valida la escena:
node scripts/validate-scene.mjs --scene scene.json
 Cuando exista una expectativa clara de idioma/escritura, valídala también:
node scripts/validate-scene.mjs --scene scene.json --expected-language <código-de-idioma>
  • Inspecciona el editor abierto o la exportación renderizada. Corrige recortes de texto, espaciado apretado, jerarquía débil, superposiciones accidentales, texto de muestra desactualizado y desviación de estilo. Prefiere corregir diagram.svg y reconvertir; usa ediciones en el JSON de la escena solo para limpieza específica de Excalidraw.
  1. Abrir el editor. Usa:
node scripts/open-editor.mjs --scene scene.json

Cada llamada inicia una URL de editor local independiente. Haz esto para cada nuevo lienzo, plantilla alternativa o versión regenerada en lugar de reutilizar una URL antigua. Por defecto, el script avanza a un puerto disponible fresco y sirve la escena desde una URL única sin caché. Un puerto se libera cuando ese proceso open-editor.mjs se detiene o la sesión del anfitrión termina.

  1. Entregar. Dale al usuario la URL local impresa. Menciona que el editor soporta cambio de interfaz entre chino/inglés, autoguardado local a prueba de actualizaciones y exportación a PNG/SVG. Ofrece volver a renderizar el mismo contenido en otro estilo.

Archivos

Prueba rápida

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 relacionados