SVG Diagrams Skill

Reference standards for authoring SVG technical diagrams (data-flow blocks, sequence, state, dispatch graphs) with a uniform plan-marshall visual language. Covers the visual style, how SVGs adapt to GitHub's light / dark themes when embedded in .adoc and .md pages, and how to embed them with the correct AsciiDoc macro.

Enforcement

Execution mode: Read the standards for the diagram type you are authoring, then hand-author the SVG (or export from a tool — Excalidraw / draw.io — and conform the output to the standards). Save under doc/resources/diagrams/{name}.svg.

Prohibited actions:

• Do not embed external assets (no <image href="https://…">). Use Base64 data URLs or inline SVG primitives only.
• Do not commit raster screenshots in place of SVG. PNG / JPG is only for content that cannot be vectorised (photographs, hero illustrations).
• Do not bake hard-coded #000 or #fff colors into diagram strokes / fills — they become invisible on the opposite theme. Use the palette tokens from standards/visual-language.md.
• Do not introduce a per-diagram font stack. The system fonts in visual-language.md are the only stack used.

Constraints: