Communitygithub.com

Zimzheng/prompt-to-canvas

Skill do agente para transformar conteúdo em canvases Excalidraw editáveis e polidas.

O que é prompt-to-canvas?

Este skill permite que um agente de IA transforme conteúdo textual fornecido pelo usuário em canvases Excalidraw visualmente polidas e totalmente editáveis. Ele não é um gerador automático de gráficos, mas um designer visual que decide a tese, estrutura, hierarquia, rótulos e conectores, usando um catálogo de estilos predefinido para paleta e clima. O processo começa identificando o conteúdo e o público, oferecendo opções de estilo e, em seguida, construindo um diagrama SVG nativo, convertendo-o em JSON de cena Excalidraw, validando a estrutura e abrindo o resultado em um editor local. Suporta o desenvolvimento de infográficos, diagramas de arquitetura, timelines, dashboards e mapas conceituais, garantindo que o texto visível (títulos, legendas) use o idioma do usuário, enquanto termos técnicos e nomes de produtos permanecem no original. O skill funciona com Node.js 20+, scripts de linha de comando e é ideal para plataformas como Claude Code, Cursor ou Codex que suportam execução de scripts e integração com editores locais.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Zimzheng/prompt-to-canvas

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Prompt para Canvas

Um skill de sistema de design para criar canvases Excalidraw editáveis e polidos a partir de conteúdo fornecido pelo usuário. O agente compõe o layout, usa o catálogo de estilos integrado para direção visual, constrói uma fonte SVG, converte-a em JSON de cena Excalidraw editável e a abre no editor local.

Isso não é um gerador automático de gráficos ou um preenchedor de modelos. O estilo fornece paleta e clima; o agente decide a tese, estrutura, agrupamento, hierarquia, rótulos e conectores.

Use o idioma principal de interação do usuário para prosa visível no canvas, títulos, rótulos de seção, anotações e legendas, a menos que o usuário peça explicitamente outro idioma. Mantenha termos técnicos, nomes de produtos, nomes de APIs, acrônimos, identificadores de código, métricas e frases citadas da fonte em seu idioma original quando isso for mais claro.

Quando usar

  • O usuário deseja um canvas editável, infográfico, diagrama, gráfico de arquitetura, linha do tempo, comparação, dashboard, mapa conceitual ou visual pronto para apresentação.
  • O usuário fornece conteúdo e pede para "desenhar", "visualizar", "transformar isso em um canvas", "fazer um quadro de portfólio" ou nomeia este skill.
  • O resultado deve ser polido, editável, exportável e visualmente estilizado.

Passo 0: pré-requisitos

Execute scripts/preflight.sh ou verifique manualmente:

  • Node 20 ou mais recente.
  • assets/editor/index.html existe.
  • scripts/svg-to-scene.mjs, scripts/validate-scene.mjs e scripts/open-editor.mjs existem.
  • CATALOG.md, RULES.md, templates/ e assets/styles/ existem.

Se algo estiver faltando, informe ao usuário o que está faltando e pare.

Como conduzir a conversa

  1. Entenda o canvas. Identifique o conteúdo, propósito e público. Se isso não estiver claro o suficiente para alterar o quadro, faça uma pergunta curta antes de construir.
    • Quando o host suportar escolhas estruturadas ou selecionáveis, use-as. Caso contrário, faça uma pergunta de texto compacta.
    • Ofereça 2-3 opções inferidas, coloque a opção recomendada primeiro e inclua uma opção "agente escolhe" no idioma do usuário quando o prompt já tiver contexto suficiente.
  2. Pergunte sobre o clima. Pergunte pelo estilo visual: sóbrio, profissional, divertido, ousado, com cara de marca, preferência de cor ou clima. Ofereça-se para escolher se o usuário não tiver preferência. Pule esta etapa se o usuário já nomeou um estilo ou clima claro.
    • Use opções selecionáveis quando o host as suportar.
    • Mapeie as opções para os níveis do catálogo: Restrained (Contido), Balanced (Equilibrado) ou Bold (Ousado).
  3. Escolha um estilo. Use CATALOG.md para escolher um estilo. Escolha apenas na tabela do catálogo; não compare vários arquivos design.md. Informe ao usuário o estilo escolhido e o motivo em uma frase.
  4. Construa. Leia RULES.md, rules/canvas-rules.md, rules/visualization-strategy.md, e apenas o templates/<slug>/design.md selecionado, então:
    • Use rules/analysis-prompt.md como uma lista de verificação editorial privada: decida o público, o trabalho do artefato, a tese central, entidades-chave, relacionamentos, trade-offs e 3-6 afirmações que merecem espaço no canvas.
    • Combine a prosa visível do canvas, títulos, rótulos de seção, anotações e legendas com o idioma principal de interação do usuário, a menos que o usuário peça o contrário. Termos técnicos, nomes de produtos, nomes de APIs, acrônimos, identificadores de código, métricas e frases citadas da fonte podem permanecer em seu idioma original quando isso for mais claro.
    • Componha diagram.svg primeiro em um espaço lógico de cerca de 1600-1700px de largura. Use formas SVG nativas: rect, circle, ellipse, line, polyline e text. Mantenha cada rótulo visível como texto.
    • Mantenha o fundo do canvas infinito do Excalidraw branco. Se o estilo escolhido tiver um papel/fundo colorido, desenhe-o como um retângulo editável dentro da cena; nunca coloque essa cor em appState.viewBackgroundColor.
    • Mantenha a seleção de estilo independente do fundo do canvas Excalidraw. Escolha por conteúdo, público, formalidade e clima; a cor do papel/fundo do modelo permanece como parte do artefato visual como um retângulo editável dentro da cena.
    • Coloque apenas o conteúdo do artefato finalizado no canvas. Contexto sobre prompts, fontes, caminhos de arquivo, estilo escolhido ou processo pertence à resposta do chat.
    • Aplique o estilo selecionado como um sistema visual: paleta, densidade, traço, tratamento de cantos, hierarquia, disciplina de destaque e clima do layout.
    • Converta o SVG em JSON de cena Excalidraw editável:
node scripts/svg-to-scene.mjs --svg diagram.svg --out scene.json
  • Valide a cena:
node scripts/validate-scene.mjs --scene scene.json
 Quando existir uma expectativa clara de idioma/escrita, valide-a também:
node scripts/validate-scene.mjs --scene scene.json --expected-language <código-do-idioma>
  • Inspecione o editor aberto ou a exportação renderizada. Corrija clipping de texto, espaçamento apertado, hierarquia fraca, sobreposições acidentais, texto de amostra desatualizado e desvio de estilo. Prefira corrigir diagram.svg e reconverter; use edições JSON de cena apenas para limpeza específica do Excalidraw.
  1. Abra o editor. Use:
node scripts/open-editor.mjs --scene scene.json

Cada chamada inicia uma URL de editor local independente. Faça isso para cada novo canvas, modelo alternativo ou versão regenerada, em vez de reutilizar uma URL antiga. Por padrão, o script avança para uma porta disponível e serve a cena a partir de uma URL única sem cache. Uma porta é liberada quando o processo open-editor.mjs correspondente é interrompido ou a sessão do host termina.

  1. Entregue. Forneça ao usuário a URL local impressa. Mencione que o editor suporta alternância de interface chinês/inglês, salvamento automático local resistente a atualizações e exportação para PNG/SVG. Ofereça-se para renderizar novamente o mesmo conteúdo em outro estilo.

Arquivos

Teste rápido

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

Habilidades Relacionadas