Create and refine Mermaid-like architecture and process diagrams, then render them to PNG with the bundled local renderer. Use when the user wants a `.mmd` source, a rendered diagram image, grouped boxes, readable orthogonal routing, relationship labels, colored connectors, or iteration on diagram clarity.
Use this skill to draft or refine Mermaid-like diagrams and render them with the bundled runtime in this checkout.
subgraph lane or section layouts.mmd source and PNG should both be updatedreferences/examples.md or assets/ for an existing pattern before drafting from scratch..mmd file in the user workspace.subgraph ... end only when it improves readabilityscripts/render_diagram.py.src/flowchart_generator/diagram.py, add or update tests in tests/test_diagram.py, and rerender the affected fixture.LR for architecture overviews and TD for pipelines when direction is not obvious.runtime error, candidate fix, or validated patch.linkStyle colors sparingly so color still communicates structure..mmd file as the source of truth and regenerate the PNG after each meaningful edit.Run:
python3 ~/.codex/skills/project-diagram/scripts/render_diagram.py diagram.mmd -o diagram.png
Optional:
python3 ~/.codex/skills/project-diagram/scripts/render_diagram.py diagram.mmd -o diagram.png --direction LR
The script runs against the bundled runtime in this checkout, reads input from the user workspace, and writes output to the requested path instead of the installed skill directory.
references/spec.md for supported syntax and rendering behavior.references/examples.md for concrete authoring patterns and starter snippets.assets/ when a fast first draft is more useful than a blank file.