/arch-diagram¶
Authoring class
Writes exactly one artifact into the repo, then proposes the commit — never runs git itself. Shared rules: CONVENTIONS-authoring.md.
Reads the project's README, architecture docs, and ADRs first to ground the diagram, then authors a presentation-quality SVG directly — infographic style by default, --sketch for a hand-drawn variant — places it into the project docs, and PROPOSES the commit. Every diagram is rendered and looked at before it ships.
At a glance¶
| Run it | /arch-diagram |
| Class | authoring |
| Version | 0.4.0 |
| Author | navjyotnishant |
| Cost | 0–1 agent calls — the diagram is normally authored inline, and diagram-architect is spawned only for a large or unfamiliar system |
| Needs | rsvg-convert (graphviz/cairo) |
| Source | skills/arch-diagram/SKILL.md |
What it needs, and what happens without it¶
Every tool is detected at runtime — none is installed for you.
| Tool | Without it |
|---|---|
rsvg-convert (graphviz/cairo) |
the visual pass is skipped — say so rather than implying it ran |
Agents it spawns¶
diagram-architect— Turn a project's docs and code structure into an architecture diagram — it reads the repo model, builds a…
The procedure¶
The executable steps live in the skill file itself and are deliberately not reproduced here: they are instructions to the model at runtime, not documentation.