Compatibility / Install
What works, measured.
Every cell is a recorded run. Green passed, red failed, gray was not measured. Nothing on this page is typed by hand: it is read from the files the tests and runs write.
36Passed
8Failed
22Not measured
| Diagram type | Template gate2026-11-07 | Claude CodeSonnet 4.5 | Claude CodeOpus 5.5 | Claude CodeSonnet 5.5 | Claude CodeHaiku 5.5 | Codex CLI | Kiro CLISonnet 4.5 |
|---|---|---|---|---|---|---|---|
| AWS architecture poster | Passed | Gate only1 | Passed2 | Passed3 | Defectno side margin2 | Not measured4 | Not measured5 |
| Numbered-step flow | Passed | Gate only1 | Defectpanel past the margin2 | Passed2 | Defectbox past the margin2 | Not measured | Not measured5 |
| Comparison table | Passed | Gate only1 | Passed2 | Passed2 | Passed2 | Not measured | Gate only5 |
| ER diagram per schema | Passed | Gate only1 | Passed2 | Passed2 | Passed2 | Not measured | Gate only5 |
| Schema dependency matrix | Passed | Gate only1 | Passed2 | Passed2 | Passed2 | Not measured | Gate only5 |
| Swimlanes | Passed | Gate only1 | Passed2 | Passed2 | Passed2 | Not measured | Gate only5 |
| Cards catalog | Passed | Gate only1 | Passed2 | Passed2 | Passed2 | Not measured | Not measured5 |
| BPMN 2.0 | Passed | Gate only1 | Passed2 | Defectone arrow crosses another2 | Passed2 | Not measured | Gate only5 |
| Sequence diagram | Passed | Defectlabels touching2 | Defectnote over activation bars2 | Passed3 | Passed2 | Not measured | Not measured |
| State machine | Passed | Defectlabels far from their arrow6 | Not measured | Not measured | Not measured | Not measured | Not measured |
| C4 container diagram | Passed | Failed3 runs7 | Passed7 | Not measured | Not measured | Not measured | Not measured |
| Passed | 11/11 | 8/11 | 8/11 | 8/11 | 7/11 | 0/11 | 5/11 |
Numbered-step flow
Comparison table
ER diagram per schema
Schema dependency matrix
Swimlanes
Cards catalog
BPMN 2.0
Sequence diagram
State machine
- Template gate
- Claude Code · Sonnet 4.5Defectlabels far from their arrow6
- Claude Code · Opus 5.5Not measured
- Claude Code · Sonnet 5.5Not measured
- Claude Code · Haiku 5.5Not measured
- Codex CLINot measured
- Kiro CLI · Sonnet 4.5Not measured
C4 container diagram
- Passed
- the PNG was produced, the gate returned 0 when re-run on the saved source, and the PNG shows no visible defect
- Gate only
- the gate returned 0; the PNG was not re-read
- Defect
- the PNG was produced and the gate returned 0, but the PNG has a visible defect the gate does not catch
- Failed
- the run did not deliver a correct diagram
- Not measured
- no run, or no run on the current skill
Installation checks
npm smoke test · 2026-11-07 · ai-diagrams 0.2.0 · Node 22.22.3 · darwin
Claude Code
- install --claude links the skill in the home folder
- install --claude --project links the skill in a project
- an existing installation is kept outside a terminal
- replacement confirmed in a terminal keeps a backup
Codex CLI
- install --codex links the skill in the home folder
- install --codex --project links the skill in a project
- an existing installation is kept outside a terminal
Kiro CLI
- install --kiro copies the skill, steering and agent
- an existing installation is kept outside a terminal
- a failed Kiro install restores every original file
Any CLI
- import converts a Mermaid file with --source-only
- 0.1.x names (importar, --projeto, --saida) still work with a warning
- doctor reports Node, Python and Chrome
Import samples
Source test and full gate of each sample in examples/import/manifest.json.
| Sample | Source test · gateen | Source test · gatees | Source test · gatept-BR |
|---|---|---|---|
| flowchart | |||
| swimlanes | |||
| sequence | |||
| state | |||
| er | |||
| process | |||
| schema | |||
| catalog | |||
| comparison | |||
| schema-matrix |
Where each result comes from
Sources: docs/models/runs.json, docs/models/gates.json, docs/models/install-checks.json and examples/import/manifest.json.
- 2026-11-04 · End-to-end run of the eight original types (all except sequence) in a clean install, before later fixes to the skill. Result: 8 of 8 with the gate at 0.
- 2026-11-06 · One run per cell, before the visual theme of this repository. The gate and the layout scripts were the same; only colors, fonts and names changed afterwards.
- 2026-11-06 · On this repository under its previous name, Claude Code 2.1.318, before the state machine, C4 and color tokens were added. Poster: one frame ends about 8 px past the right margin (5 gate calls, 5 min 34 s, US$0.53). Sequence: 7 gate calls, 2 rejected and then fixed (6 min 12 s, US$0.41). Before the theme change, the same model also passed both types.
- 2026-11-04 · Codex CLI was not measured on this repository. Before the theme change, one poster run passed the gate (2026-11-04); its PNG was not re-read.
- Kiro round 2, before later fixes to the skill. Poster, step flow and cards were not run again after those fixes: the account hit the request limit.
- 2026-11-06 · One run. The gate returned 0, but two-line labels sat far from their arrow. The generator was fixed and the PNG regenerated from the same spec; the model was not run again.
- 2026-11-06 · Sonnet 4.5, three runs: the first delivered a PNG without CSS, the second passed the gate of the time with arrows starting inside boxes and a loose label (that source became the negative test tests/negative/c4-arrows.html), the third passed the new gate but one arrow reached the wrong system. Opus 5.5, one run: gate 0 and a clean PNG, 11 relations, all to the right target. It is the result in examples/c4/output/.
Install ai-diagrams
Choose your CLI, check the requirements, and run the documented steps.
Published on npm as ai-diagrams. npx downloads it on first use.
Install in npmbash
npx ai-diagrams install --claude
# Or install the CLI globally.
npm install -g ai-diagrams
ai-diagrams install --claude
ai-diagrams doctorExpected output
The skill is installed for the selected CLI. doctor reports Python 3, Chrome and Node availability.
Use --codex or --kiro instead of --claude. For a project installation, add --project <PROJECT>.
An existing installation is never replaced without confirmation. Keep the package installed while linked skills are in use.
Installation source: INSTALL.md. The diagram workflow uses local headless Chrome; this site does not need it.