SVG Diagram Skill
mengzhou0125/svg-diagram-skill
Gera diagramas SVG técnicos com sistema de design plugável
Ver no GitHubSkill para Claude que gera diagramas SVG standalone — arquitetura, fluxogramas, matrizes de decisão, árvores hierárquicas e figuras de comparação. Possui sistema de design plugável com suporte ao padrão Evidence Poet como estilo visual padrão e permite especificações customizadas.
Instalação
npx convez-ai mengzhou0125/svg-diagram-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar diagramas de arquitetura de software
- Criar fluxogramas e matrizes de decisão
- Produzir visualizações de hierarquias e conceitos
- Documentação técnica com estilo visual consistente
Veredito

Ferramenta especializada e bem arquitetada para geração de diagramas técnicos com suporte a sistema de design customizável. Ideal para equipes que precisam de diagramas standalone com consistência visual — a abordagem plugável evita lock-in em um único estilo.
README
A tradução para o português deste README ainda está na fila.
svg-diagram-skill
A Claude Code skill that generates standalone SVG diagrams — architecture diagrams, flow charts, decision matrices, hierarchy trees, comparison figures, concept-framework figures.
Pluggable design system. Bundles the Evidence Poet spec as the default
visual style. Accept any external spec following the simple spec-interface.md contract.
Evidence Poet default character: academic journal × architecture magazine — mono labels for information order, serif headlines for narrative weight, gold lines for moments worth pausing. Sharp corners. Restrained, rational, never cold.
Install
git clone https://github.com/mengzhou0125/svg-diagram-skill.git
cd svg-diagram-skill
./install.sh # macOS / Linux / Git Bash
.\install.ps1 # Windows PowerShell
Idempotent — re-run to update. Copies the skill to ~/.claude/skills/svg-diagram-skill/.
Trigger it
draw an architecture / flow / hierarchy / matrix / comparison / concept diagram
draw an Evidence Poet-styled SVG diagram
用 SVG 画一个 [架构图 / 流程图 / 决策矩阵 / 概念框架图]
/svg-diagram
How it works
- Step 0 · Resolve a spec —
--spec=<path>argument · or auto-detect<project>/.claude/design.md· or fall back to bundledspecs/default-spec.md - Read the 4 reference files (
spec-interface·svg-spec·chart-types·generation-method) - Pick a chart type (TYPE A–F decision tree)
- Describe the structure in chat first — node list · connections · canvas estimate · color theme · file name · spec in use. Wait for your sign-off.
- Generate with the Python-list method (no bash heredoc · canvas top-down from content · pre-write placeholder check)
- Validate (XML syntax · waste-ratio < 15% · spec-compliance)
- Save the
.svg· report the path
For independent design-system compliance audit (separate from the skill's structural
validation): use a spec-driven auditor. The
evidence-poet-auditor covers
Evidence Poet; for other specs, bring your own.
Pluggable design system
Three ways the skill resolves which spec to use, in priority order:
| Priority | Source | When |
|---|---|---|
| 1 | --spec=<path> arg or user prompt names a path | explicit |
| 2 | <project>/.claude/design.md | the Evidence Poet Design System installer (EPDS) has been run · or any compatible |
| 3 | bundled specs/default-spec.md | default · Evidence Poet |
To bring your own spec, write a markdown file with a §0 JSON block following the contract
in references/spec-interface.md. The contract is narrow
(~15 tokens) — colors · fonts · spacing · line widths · corner convention · easing.
What it does NOT do
- Does not install a design system into your project — for Evidence Poet, use evidence-poet-installer
- Does not build non-diagram visuals (React components, pages, content-review HTML)
- Does not audit existing artifacts — use a spec-driven auditor (see Verification above)
- Does not modify application source — emits standalone
.svgand leaves integration to the caller
Companion tools
| Tool | Repo | Role |
|---|---|---|
evidence-poet-design-system | evidence-poet-design-system | The Evidence Poet design system: installer + builder + auditor. The visual style bundled here as specs/default-spec.md. |
html-review-skill | html-review-skill | Sibling tool · same pluggable-spec pattern · for content-review HTMLs |
Files
SKILL.md Claude's manifest
README.md this file
LICENSE MIT
install.sh / install.ps1 copies the skill to ~/.claude/skills/
references/
spec-interface.md 🆕 the design-system spec contract
svg-spec.md how a spec applies to SVG (themes · fonts · geometry · spacing)
chart-types.md TYPE A–F decision tree + layout templates
generation-method.md Python-list method + validation pipeline
specs/
default-spec.md 🆕 bundled default · Evidence Poet spec (mirror of the EPDS canonical)
License
MIT. See LICENSE.