O repositório cathrynlavery/diagram-design, em alta no GitHub, é uma skill para agentes de código que gera diagramas em um único arquivo HTML com SVG. O projeto diz oferecer dezenas de tipos de diagrama e aplicar cores e fontes da marca do usuário. O código é MIT e já passa de 69 mil estrelas.
O que é e que problema resolve
A skill dá ao agente de código regras de design para desenhar diagramas. Segundo o site, o modelo já entende o conteúdo, mas falta critério visual. O autor diz ter escrito esse critério em regras.
O projeto promete uma cor de destaque única, hierarquia por peso tipográfico e agrupamento, em vez de vários preenchimentos coloridos. Diz também que não usa sombras nem o visual padrão do Mermaid.
O pedido é em linguagem natural, por exemplo um diagrama de arquitetura com frontend, backend, banco de dados e cache Redis. O agente escolhe o tipo, descreve o plano e grava um arquivo.html que abre com duplo clique, offline.
Como funciona
O site fala em 50 tipos de diagrama e o README, em 51; a descrição do repositório cita 45. Entre eles estão arquitetura, Sankey, mapa de calor, esquema de banco de dados e dois tipos axonométricos. Segundo o site, cada tipo tem regras próprias. A animação é opcional e os diagramas são estáticos por padrão.
Ao receber o endereço de um site, a skill lê cores e fontes e as aplica aos diagramas seguintes. O projeto fala em cerca de 60 segundos para esse ajuste. Perfis salvos ficam em ~/.diagram-design/profiles/.
A skill também importa fontes do draw.io, do Mermaid e do Excalidraw. O projeto diz que ela redesenha o diagrama, em vez de apenas converter. Segundo ele, leitores de tela recebem título e descrição de cada diagrama.
Como começar e o que é preciso
A instalação usa o comando npx skills add com o nome do repositório. Funciona em hosts que leem Agent Skills, como Cursor, Claude Code, Codex, GitHub Copilot, Gemini CLI, Cline, Windsurf e Amp. Kiro, OpenCode e Pi têm instruções próprias.
No Claude Code, o marketplace de plugins traz atualizações e comandos como /export-diagram, /import-mermaid e /doctor. A instalação via CLI cobre só a skill, sem esses comandos.
Maturidade e cuidados
O repositório foi criado em 16 de abril de 2026 e recebeu o último commit em 19 de novembro. Tem 69.253 estrelas, 4.654 forks e 634 estrelas novas hoje no GitHub Trending. A licença é MIT.
O README afirma que as versões oficiais saem só desse repositório e que listagens com outro nome são cópias não oficiais. O arquivo PRIVACY.md detalha o que a skill envia pela rede, o que vale ler antes de adotar.
Pontos-chave
- No Claude Code, o auto-update vem desligado por padrão para marketplaces de terceiros e precisa ser ativado em /plugin
- Quem instala pela CLI e depois migra para o marketplace do Codex precisa remover a cópia avulsa antes
- No Pi, as atualizações dependem de rodar pi update --extensions
- No Claude Cowork, a instalação exige espelhar o repositório público em um repositório privado ou interno da organização
Texto escrito por IA a partir das reportagens e páginas listadas abaixo e checado contra elas por uma segunda revisão automática. Atualizado em 20/11/2026 às 20:15 (Brasília).
Fontes usadas no texto
Anúncio oficial
Site do projeto diagram-design diagramdesign.devSite oficial descreve os tipos de diagrama, o ajuste à marca, as importações, a acessibilidade e os perfis salvos.
GitHub
cathrynlavery/diagram-design no GitHub GitHub · 2026-11-20README lista hosts compatíveis, formas de instalação e atualização, o aviso sobre cópias não oficiais e o PRIVACY.md.


