convez.ai
SkillDesign & UIIntermediário
mengzhou0125

SVG Diagram Skill

mengzhou0125/svg-diagram-skill

Gera diagramas SVG técnicos com sistema de design plugável

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-skill

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

  1. Step 0 · Resolve a spec — --spec=<path> argument · or auto-detect <project>/.claude/design.md · or fall back to bundled specs/default-spec.md
  2. Read the 4 reference files (spec-interface · svg-spec · chart-types · generation-method)
  3. Pick a chart type (TYPE A–F decision tree)
  4. Describe the structure in chat first — node list · connections · canvas estimate · color theme · file name · spec in use. Wait for your sign-off.
  5. Generate with the Python-list method (no bash heredoc · canvas top-down from content · pre-write placeholder check)
  6. Validate (XML syntax · waste-ratio < 15% · spec-compliance)
  7. 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:

PrioritySourceWhen
1--spec=<path> arg or user prompt names a pathexplicit
2<project>/.claude/design.mdthe Evidence Poet Design System installer (EPDS) has been run · or any compatible
3bundled specs/default-spec.mddefault · 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 .svg and leaves integration to the caller

Companion tools

ToolRepoRole
evidence-poet-design-systemevidence-poet-design-systemThe Evidence Poet design system: installer + builder + auditor. The visual style bundled here as specs/default-spec.md.
html-review-skillhtml-review-skillSibling 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.

Ver o original no GitHub

Bom para

Relacionados