diagrams-as-code · diff

git:20261101.250e2b3 to git:20261107.e294cb4

2 added, 2 removed. Audit A to A.

---

name: diagrams-as-code

description: "Create and check Mermaid, SVG, and D2 diagrams and illustrations."

license: MIT

metadata:

kind: task

author: Médéric HURIER (Fmind)

source: github.com/fmind/dot/tree/main/skills/diagrams-as-code

created: "2026-09-16"

- updated: "2026-11-01"

+ updated: "2026-11-07"

---

# Diagrams as Code

- 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; [fmind-visuals](../fmind-visuals/SKILL.md) owns brand, decks, and terminal demos.

+ 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; [fmind-visuals](../fmind-visuals/SKILL.md) owns brand, terminal demos, and logo or cover variants.

| Need | Format | Why |

| ----------------------------------------------------------------------------- | -------------------------------- | ---------------------------------------------------------- |

| Technical docs: AGENTS.md, skills, architecture, contributor, reference | [Mermaid](references/mermaid.md) | Renders in Markdown and GitHub; maintainers edit structure |

| User docs: README, documentation-site landing and concept pages, courses | [SVG](references/svg/GUIDE.md) | Composed, branded illustration that carries one concept |

| Existing `.d2` sources, Fmind-branded D2 diagrams, bespoke standalone layouts | [D2](references/d2.md) | Containers, layers, and exports Mermaid cannot express |

## Workflow

Read only the matching guide and its required resources.

## Task guides

- [d2](references/d2.md): D2 sources, standalone layouts, theming, and exports.

- [mermaid](references/mermaid.md): Technical-doc diagrams in Markdown and GitHub: syntax, validation, and rendering.

- [svg](references/svg/GUIDE.md): Hand-authored SVG illustrations for READMEs and user docs: composition, branding, embedding, and visual checks.