technical-diagram

Installation
SKILL.md

Technical Diagram

Produce the smallest accurate technical figure. D2 is the default authoring language, ELK owns layout, and SVG is the primary deliverable. Keep the source beside the render so the diagram remains reproducible without a GUI.

Quick path

  1. Form the reader brief in the content contract below. Reduce the source to one question and one answer before choosing nodes.

  2. Derive the required nodes, edges, groups, and annotations from that brief. Source facts that do not support the answer stay outside the figure.

  3. Read references/editorial-principles.md and references/d2-authoring.md.

  4. Copy assets/editorial-theme.d2 beside the new source and import it. Author only the semantic structure in the main .d2 file.

  5. Format the source with d2 fmt <file>.d2, then render it with:

    bash scripts/render_d2.sh <file>.d2 <file>.svg
    
  6. Inspect the rendered SVG, using a temporary PNG proof when the available viewer cannot display SVG. Apply references/review.md, remove any unrequired content, and render again after each fix.

Communication and content contract

Installs
5
First Seen
6 days ago
technical-diagram — gigio1023/gigio-figures