{"slug":"diagrams-as-code","title":"diagrams-as-code","summary":"Create and check Mermaid, SVG, and D2 diagrams and README illustrations.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-23T17:42:39.651117Z","repo":{"url":"https://github.com/fmind/dot","stars":13,"forks":0,"license":"MIT","updatedAt":"2026-11-12T20:32:33Z"},"bodyHtml":"<hr>\n<h2>name: diagrams-as-code\ndescription: \"Create and check Mermaid, SVG, and D2 diagrams and README illustrations.\"\nlicense: MIT\nmetadata:\nkind: task\nauthor: Médéric HURIER (Fmind)\nsource: github.com/fmind/dot/tree/main/skills/diagrams-as-code\ncreated: \"2026-09-16\"\nupdated: \"2026-10-16\"</h2>\n<h1>Diagrams as Code</h1>\n<p>Choose the simplest picture that explains the system, or none when prose, a list, or a table is more direct. This skill owns the format choice; <a href=\"../fmind-visuals/SKILL.md\">fmind-visuals</a> owns brand, decks, and terminal demos.</p>\n<table>\n<thead>\n<tr>\n<th>Need</th>\n<th>Format</th>\n<th>Why</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>Technical docs: AGENTS.md, skills, architecture, contributor, reference</td>\n<td><a href=\"references/mermaid.md\">Mermaid</a></td>\n<td>Renders in Markdown and GitHub; maintainers edit structure</td>\n</tr>\n<tr>\n<td>User docs: README, documentation-site landing and concept pages, courses</td>\n<td><a href=\"references/svg/GUIDE.md\">SVG</a></td>\n<td>Composed, branded illustration that carries one concept</td>\n</tr>\n<tr>\n<td>Existing <code>.d2</code> sources, Fmind article diagrams, bespoke standalone layouts</td>\n<td><a href=\"references/d2.md\">D2</a></td>\n<td>Containers, layers, and exports Mermaid cannot express</td>\n</tr>\n</tbody>\n</table>\n<h2>Workflow</h2>\n<p>Read only the matching guide and its required resources. Use a known guide directly when shared prerequisites are not needed.</p>\n<h2>Task guides</h2>\n\n<ul>\n<li><a href=\"references/d2.md\">d2</a>: D2 sources, standalone layouts, theming, and exports.</li>\n<li><a href=\"references/mermaid.md\">mermaid</a>: Technical-doc diagrams in Markdown and GitHub: syntax, validation, and rendering.</li>\n<li><a href=\"references/svg/GUIDE.md\">svg</a>: Hand-authored SVG illustrations for READMEs and user docs: composition, branding, embedding, and visual checks.</li>\n</ul>\n\n","files":[{"path":"references/d2.md","sizeBytes":2464,"isText":true},{"path":"references/mermaid.md","sizeBytes":3556,"isText":true},{"path":"references/recording/GUIDE.md","sizeBytes":3995,"isText":true},{"path":"references/recording/templates/demo.tape","sizeBytes":521,"isText":false},{"path":"references/svg/GUIDE.md","sizeBytes":3546,"isText":true},{"path":"references/svg/scripts/check_svg.py","sizeBytes":10606,"isText":true},{"path":"references/svg/templates/illustration.svg","sizeBytes":5819,"isText":false},{"path":"references/variants/GUIDE.md","sizeBytes":1459,"isText":true},{"path":"references/variants/scripts/gallery.py","sizeBytes":5791,"isText":true},{"path":"SKILL.md","sizeBytes":3080,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-11-12T21:47:39.250641Z","sha256":"02D69D4429D1EA4200D10408AFDD8FBA35377F3CAA5349B40962FF06B451F6C2","sizeBytes":19761},"review":null,"source":{"repositoryUrl":"https://github.com/fmind/dot","path":"skills/diagrams-as-code","license":"MIT","commit":"3bbe8303052db130faddc36c3df828ddb44e34d3","subtreeSha":"F691BBB31C678B00666AC07F5F87C1332E06DED06C1990C8FDFD88F23F807BE1","lastSyncedAt":"2026-11-12T21:44:53.841763Z"},"reviewedAt":"2026-11-12T21:53:53.956245Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/fmind/dot/tree/main/skills/diagrams-as-code"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install fmind-dot@llmmart"},{"target":"git","command":"git clone https://github.com/fmind/dot.git"}]}