Cria diagramas tecnicos e valida sua sintaxe e coerencia. Trigger em: "diagrama de arquitetura", "diagrama de classe", "diagrama de sequência", "UML", "diagrama de deployment", "diagrama ER", "state machine diagram", "gerar diagrama técnico", "diagrama com validação", "SVG determinístico", "diagrama fica desalinhado", "roteamento ortogonal", "geometry-safe diagram", "diagrama de componentes".
71%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./skills/76-diagram-validated/SKILL.mdO princípio que governa esta skill: avalie, não afirme — a conclusão de que um diagrama está pronto é sustentada por validador e evidência de render, nunca pelo modelo dizendo que "parece correto" ao olhar o SVG cru. Aplica aos diagramas a mesma disciplina que as skills 11 e 53 aplicam a código: verificação mecânica antes de declarar concluído.
Esta skill segue GLOBAL.md, policies/execution.md, policies/verification-before-completion.md, policies/self-correcting-sensors.md e policies/tool-safety.md.
Adaptação de motor de renderização — leia antes de usar: o projeto de origem (ver ## Fontes) converte SVG→PNG via Puppeteer controlando Chrome headless. Essa dependência não foi portada — exigiria Node + download de binário Chromium (~200MB) só para rasterizar. Esta skill usa ImageMagick (magick, já presente no ambiente de referência) como motor de conversão. Fidelidade testada e confirmada para: retângulo com rx (border-radius), texto com font-family/font-size, linearGradient, marker (seta) com orient="auto". Não testado: foreignObject, filter (blur/drop-shadow via SVG filter), fontes customizadas via @font-face embutido. Se o diagrama usar algum desses recursos, verificar o PNG de saída com atenção redobrada antes de confiar na fidelidade — o Chrome do upstream tem suporte SVG mais completo que o delegate do ImageMagick.
graphify-out/graph.html), já instalado e mantidoskills/10-documenter/SKILL.md (seção "Roteamento de Representação")skills/17-image-generator ou anthropic-skills:canvas-designarchitecture/flow para diagramas livres)diagrama.svg — SVG determinístico, mesma entrada sempre produz o mesmo layoutdiagrama.png — readback visual, gerado via magick, usado para a verificação antes de declarar prontoAntes de gerar SVG, estruturar o conteúdo como IR semântico — containers, nós com kind, setas com flow (direção), âncoras de porta explícitas. Não gerar SVG diretamente de prosa sem passar por essa estrutura intermediária: é o que garante determinismo entre re-gerações.
14 tipos UML suportados: Class, Component, Deployment, Package, Composite Structure, Object, Use Case, Activity, State Machine, Sequence, Communication, Timing, Interaction Overview, ER. Mais dois tipos livres: architecture e flow, para diagramas que não seguem uma notação UML formal.
12 estilos visuais:
| # | Estilo | Uso |
|---|---|---|
| 1 | Flat Icon (padrão) | uso geral, ícones planos |
| 2 | Dark Terminal | contexto de dev tools, CLI |
| 3 | Blueprint | arquitetura técnica formal |
| 4 | Notion Clean | documentação leve, minimalista |
| 5 | Glassmorphism | apresentação, marketing técnico |
| 6 | Claude Official | branding Anthropic |
| 7 | OpenAI Official | branding OpenAI |
| 8 | Dark Luxury | SVG autorado por IA, não gerado por template — usar com cautela, menos previsível |
| 9 | C4 Review Canvas | diagrama C4 (contexto/container/componente) |
| 10 | Cloud Fabric | arquitetura cloud/infra |
| 11 | Event Transit | arquitetura orientada a evento, filas, streams |
| 12 | Ops Pulse | observabilidade, dashboards operacionais |
python3 scripts/fireworks.py validate <tipo> <contrato.json>Confirma que o contrato é válido antes de gastar o passo de render — falha rápido em vez de gerar SVG malformado.
python3 scripts/fireworks.py render <tipo> <contrato.json> diagrama.svg --report layout.jsonO layout.json reporta as posições calculadas — usar para debugar um roteamento inesperado sem precisar abrir o SVG.
python3 scripts/fireworks.py check diagrama.svgVerifica: integridade de XML e marker, nó semântico, região reservada, rótulo, canvas, sobreposição de aresta, e cruzamento de aresta. Roteamento ortogonal determinístico com waypoints exatos — uma seta não "passa por cima" de um nó por acidente de layout.
magick diagrama.svg diagrama.pngEste é o passo que substitui o export-png do upstream (que usa Puppeteer). Depois de gerar o PNG, olhar o resultado — não presumir que passou no check geométrico significa que está visualmente correto. Os dois são checks complementares: check pega problema estrutural (aresta não conectada, sobreposição), o PNG pega problema que só aparece ao renderizar (cor ilegível, texto cortado por fonte diferente da esperada, elemento fora do viewBox visualmente mesmo que matematicamente "dentro").
Nunca pular este passo e declarar o diagrama pronto só porque o check passou. Validador geométrico e evidência de render são as duas pernas do "avalie, não afirme" — uma sem a outra é afirmação disfarçada de validação.
check — pula a validação estruturalcheck tenha passadoforeignObject, filter, ou fonte customizada embutida sem verificar o PNG com atenção redobradacheck rodado e sem erro de geometria (XML, marker, nó, região reservada, rótulo, canvas, sobreposição/cruzamento de aresta)magick e inspecionado visualmente — não só "o comando rodou sem erro"Seguir policies/handoffs.md.
Skill adaptada de yizhiyanhua-ai/fireworks-tech-graph (MIT) — o princípio "avalie, não afirme" (citado verbatim do README do projeto), os 14 tipos de diagrama UML, os 12 estilos nomeados, o pipeline validate→render→check, e a disciplina de verificação de geometria (marker, região reservada, sobreposição/cruzamento de aresta) foram traduzidos e adaptados. Divergência deliberada do upstream: o motor de conversão SVG→PNG do projeto original usa Puppeteer/Chrome headless (scripts/svg2png.js); esta skill usa ImageMagick (magick) para evitar a dependência de Node + download de binário Chromium — fidelidade visual testada e confirmada para os elementos SVG comuns em diagrama técnico (retângulo, texto, gradiente, marker/seta), não testada para foreignObject/filter/fonte embutida.
felvieira/claude-skills-fv
b0cbfa3
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.