Sobre o projeto

Excalidraw Diagram Skill é um pacote de skill para agentes de codificação que gera diagramas Excalidraw a partir de descrições em linguagem natural. Ele é projetado para agentes que carregam skills de um diretório `.claude/skills/`, como Claude Code e OpenCode, e pode ser copiado para um projeto para habilitar a geração de diagramas. O projeto enfatiza diagramas que "argumentam visualmente" em vez de apenas exibir informações. De acordo com o README, formas e grupos de formas são escolhidos para espelhar o conceito representado, como leques para relacionamentos um-para-muitos, linhas do tempo para sequências e convergência para agregação, em vez de grades uniformes de cartões. Diagramas técnicos podem incluir trechos de código reais e payloads JSON como artefatos de evidência. Uma característica notável é a validação visual integrada. Um pipeline de renderização baseado em Playwright permite que o agente visualize sua própria saída, detecte problemas de layout, como texto sobreposto, setas desalinhadas ou espaçamento desequilibrado, e itere antes de entregar o diagrama final. Cores e estilo de marca são centralizados em `references/color-palette.md`, então substituir esse arquivo faz todos os diagramas seguirem uma paleta diferente. A instalação envolve clonar o repositório e copiá-lo para `.claude/skills/excalidraw-diagram`. A configuração do pipeline de renderização pode ser delegada ao agente de codificação apontando-o para SKILL.md, ou feita manualmente com `uv sync` e `uv run playwright install chromium` dentro do diretório references. O uso é então tão simples quanto pedir ao agente para criar um diagrama, por exemplo, um mostrando como o protocolo AG-UI transmite eventos de um agente de IA para uma interface de usuário frontend; a skill lida com mapeamento de conceitos, layout, geração JSON, renderização e validação visual. A estrutura do repositório inclui SKILL.md para metodologia de design e fluxo de trabalho, além de references contendo a paleta de cores, templates de elementos, documentação do schema JSON, um renderizador Python para converter arquivos `.excalidraw` em PNG, um template HTML de renderização e dependências Python para Playwright.