Skip to content

drafael/coding-harness / skills/diagram-design

diagram-design

Verified

Create branded architecture, IT current-state, flowchart, sequence, state machine, ER/data model, timeline, swimlane, quadrant, radar/spider, polar chart (polar/radial lollipop), loop/flywheel, nested, tree, org chart, layer stack, Venn, pyramid/funnel, treemap, bar, line, Gantt and scatter charts, high-level, process, medallion, data flow, DP integration, DP security matrix, Sankey, fishbone, Wardley map, kanban, user journey, deployment, dependency graph, UML class, story map, or database schema diagrams as standalone HTML/SVG/PNG. Redraw .drawio/.drawio.png/.drawio.svg or Mermaid .mmd sources at a chosen size/detail; onboard brand tokens from a website; add semantic patterns, callouts, accessible motion, or sketchy/hand-drawn styling.

FileKindSize
LICENSEother1.0 KB
README.mdmarkdown5.6 KB
SKILL.mdskill md38.6 KB
THIRD_PARTY_LICENSES.mdmarkdown2.6 KB
assets/example-architecture-dark.htmlother11.8 KB
assets/example-architecture-full.htmlother14.6 KB
assets/example-architecture.htmlother11.8 KB
assets/example-bar-dark.htmlother8.8 KB
assets/example-bar-full.htmlother11.0 KB
assets/example-bar.htmlother8.7 KB
assets/example-bubble-dark.htmlother11.2 KB
assets/example-bubble-full.htmlother14.8 KB
assets/example-bubble.htmlother11.1 KB
assets/example-data-flow-dark.htmlother12.7 KB
assets/example-data-flow-full.htmlother15.5 KB
assets/example-data-flow.htmlother12.5 KB
assets/example-datalake-dark.htmlother24.3 KB
assets/example-datalake-full.htmlother27.7 KB
assets/example-datalake.htmlother25.8 KB
assets/example-db-schema-dark.htmlother24.1 KB
assets/example-db-schema-full.htmlother27.0 KB
assets/example-db-schema.htmlother23.9 KB
assets/example-dependency-dark.htmlother17.4 KB
assets/example-dependency-full.htmlother20.6 KB
assets/example-dependency.htmlother17.2 KB
assets/example-deployment-dark.htmlother13.2 KB
assets/example-deployment-full.htmlother16.4 KB
assets/example-deployment.htmlother13.1 KB
assets/example-dp-integration-dark.htmlother14.4 KB
assets/example-dp-integration-full.htmlother16.9 KB
assets/example-dp-integration.htmlother14.4 KB
assets/example-dp-security-matrix-dark.htmlother10.0 KB
assets/example-dp-security-matrix-full.htmlother12.3 KB
assets/example-dp-security-matrix.htmlother10.7 KB
assets/example-er-dark.htmlother13.9 KB
assets/example-er-full.htmlother16.7 KB
assets/example-er.htmlother13.8 KB
assets/example-fishbone-dark.htmlother8.5 KB
assets/example-fishbone-full.htmlother11.1 KB
assets/example-fishbone.htmlother8.4 KB
assets/example-flowchart-dark.htmlother9.0 KB
assets/example-flowchart-full.htmlother11.9 KB
assets/example-flowchart.htmlother9.0 KB
assets/example-gantt-dark.htmlother10.0 KB
assets/example-gantt-full.htmlother11.6 KB
assets/example-gantt.htmlother9.8 KB
assets/example-high-level-dark.htmlother23.6 KB
assets/example-high-level-full.htmlother27.8 KB
assets/example-high-level-vertical-dark.htmlother24.4 KB
assets/example-high-level-vertical-full.htmlother28.1 KB
assets/example-high-level-vertical.htmlother29.7 KB
assets/example-high-level.htmlother26.3 KB
assets/example-import-drawio.htmlother11.8 KB
assets/example-import-mermaid.htmlother7.9 KB
assets/example-it-state-dark.htmlother11.7 KB
assets/example-it-state-full.htmlother13.9 KB
assets/example-it-state.htmlother12.2 KB
assets/example-journey-dark.htmlother8.9 KB
assets/example-journey-full.htmlother11.5 KB
assets/example-journey.htmlother8.9 KB
assets/example-kanban-dark.htmlother10.8 KB
assets/example-kanban-full.htmlother13.6 KB
assets/example-kanban.htmlother10.7 KB
assets/example-layers-dark.htmlother6.8 KB
assets/example-layers-full.htmlother9.8 KB
assets/example-layers.htmlother6.7 KB
assets/example-line-dark.htmlother7.3 KB
assets/example-line-full.htmlother9.8 KB
assets/example-line.htmlother7.3 KB
assets/example-loop-dark.htmlother6.7 KB
assets/example-loop-full.htmlother9.7 KB
assets/example-loop-terminal.htmlother9.8 KB
assets/example-loop.htmlother6.6 KB
assets/example-medallion-dark.htmlother12.7 KB
assets/example-medallion-full.htmlother15.5 KB
assets/example-medallion.htmlother12.6 KB
assets/example-nested-dark.htmlother6.6 KB
assets/example-nested-full.htmlother9.6 KB
assets/example-nested.htmlother6.7 KB
assets/example-org-chart-dark.htmlother11.3 KB
assets/example-org-chart-full.htmlother11.8 KB
assets/example-org-chart.htmlother11.3 KB
assets/example-paved-road-animated.htmlother27.6 KB
assets/example-polar-dark.htmlother10.2 KB
assets/example-polar-full.htmlother12.4 KB
assets/example-polar.htmlother10.1 KB
assets/example-policy-trace-animated.htmlother24.9 KB
assets/example-process-dark.htmlother14.7 KB
assets/example-process-full.htmlother17.1 KB
assets/example-process.htmlother14.6 KB
assets/example-pyramid-dark.htmlother6.5 KB
assets/example-pyramid-full.htmlother9.5 KB
assets/example-pyramid.htmlother6.4 KB
assets/example-quadrant-consultant.htmlother11.6 KB
assets/example-quadrant-dark.htmlother6.5 KB
assets/example-quadrant-full.htmlother9.4 KB
assets/example-quadrant.htmlother6.4 KB
assets/example-queue-animated.htmlother29.2 KB
assets/example-radar-dark.htmlother7.5 KB
assets/example-radar-full.htmlother10.2 KB
assets/example-radar.htmlother7.7 KB
assets/example-ridgeline-dark.htmlother10.1 KB
assets/example-ridgeline-full.htmlother13.9 KB
assets/example-ridgeline.htmlother10.0 KB
assets/example-sankey-dark.htmlother8.8 KB
assets/example-sankey-full.htmlother11.5 KB
assets/example-sankey.htmlother8.7 KB
assets/example-scatter-dark.htmlother9.3 KB
assets/example-scatter-full.htmlother11.3 KB
assets/example-scatter.htmlother9.2 KB
assets/example-sequence-dark.htmlother13.5 KB
assets/example-sequence-full.htmlother17.8 KB
assets/example-sequence-oauth-dark.htmlother11.8 KB
assets/example-sequence-oauth-full.htmlother16.2 KB
assets/example-sequence-oauth.htmlother14.0 KB
assets/example-sequence.htmlother13.4 KB
assets/example-slopegraph-dark.htmlother10.2 KB
assets/example-slopegraph-full.htmlother13.6 KB
assets/example-slopegraph.htmlother10.1 KB
assets/example-state-dark.htmlother8.5 KB
assets/example-state-full.htmlother11.4 KB
assets/example-state.htmlother8.5 KB
assets/example-story-map-dark.htmlother12.0 KB
assets/example-story-map-full.htmlother15.1 KB
assets/example-story-map.htmlother11.9 KB
assets/example-swimlane-dark.htmlother10.3 KB
assets/example-swimlane-full.htmlother13.2 KB
assets/example-swimlane.htmlother10.2 KB
assets/example-timeline-dark.htmlother7.2 KB
assets/example-timeline-full.htmlother10.1 KB
assets/example-timeline.htmlother7.2 KB
assets/example-tree-dark.htmlother10.8 KB
assets/example-tree-full.htmlother13.7 KB
assets/example-tree.htmlother10.7 KB
assets/example-treemap-dark.htmlother7.5 KB
assets/example-treemap-full.htmlother10.5 KB
assets/example-treemap.htmlother7.4 KB
assets/example-uml-class-dark.htmlother12.1 KB
assets/example-uml-class-full.htmlother15.3 KB
assets/example-uml-class.htmlother12.1 KB
assets/example-venn-dark.htmlother6.5 KB
assets/example-venn-full.htmlother9.7 KB
assets/example-venn.htmlother5.0 KB
assets/example-wardley-dark.htmlother8.7 KB
assets/example-wardley-full.htmlother11.1 KB
assets/example-wardley.htmlother8.7 KB
assets/icons.htmlother106.0 KB
assets/index.htmlother15.2 KB
assets/template-dark.htmlother3.1 KB
assets/template-full.htmlother22.0 KB
assets/template-motion.htmlother19.4 KB
assets/template-terminal.htmlother4.8 KB
assets/template.htmlother3.2 KB
local-patches/playwright-chromium-discovery.patchother32.2 KB
references/animation.mdmarkdown11.5 KB
references/doctor.mdmarkdown5.4 KB
references/export.mdmarkdown8.3 KB
references/import-drawio.mdmarkdown12.8 KB
references/import-mermaid.mdmarkdown8.7 KB
references/onboarding.mdmarkdown13.5 KB
references/output-spec.mdmarkdown10.9 KB
references/primitive-annotation.mdmarkdown1.7 KB
references/primitive-icons.mdmarkdown103.5 KB
references/primitive-sketchy.mdmarkdown1.7 KB
references/primitive-terminal.mdmarkdown3.8 KB
references/profiles.mdmarkdown13.9 KB
references/semantic-patterns.mdmarkdown10.1 KB
references/style-guide.mdmarkdown8.5 KB
references/type-architecture.mdmarkdown4.9 KB
references/type-bar.mdmarkdown13.3 KB
references/type-data-flow.mdmarkdown20.8 KB
references/type-db-schema.mdmarkdown4.8 KB
references/type-dependency.mdmarkdown4.1 KB
references/type-deployment.mdmarkdown4.1 KB
references/type-dp-integration.mdmarkdown21.7 KB
references/type-dp-security-matrix.mdmarkdown18.6 KB
references/type-er.mdmarkdown1.5 KB
references/type-fishbone.mdmarkdown5.6 KB
references/type-flowchart.mdmarkdown1.1 KB
references/type-gantt.mdmarkdown2.4 KB
references/type-high-level.mdmarkdown26.1 KB
references/type-it-state.mdmarkdown29.3 KB
references/type-journey.mdmarkdown5.0 KB
references/type-kanban.mdmarkdown4.2 KB
references/type-layers.mdmarkdown1.5 KB
references/type-line.mdmarkdown26.8 KB
references/type-loop.mdmarkdown12.3 KB
references/type-medallion.mdmarkdown21.7 KB
references/type-nested.mdmarkdown1.4 KB
references/type-org-chart.mdmarkdown3.0 KB
references/type-polar.mdmarkdown7.6 KB
references/type-process.mdmarkdown27.9 KB
references/type-pyramid.mdmarkdown1.7 KB
references/type-quadrant.mdmarkdown6.1 KB
references/type-radar.mdmarkdown5.5 KB
references/type-sankey.mdmarkdown8.7 KB
references/type-scatter.mdmarkdown11.0 KB
references/type-sequence.mdmarkdown6.5 KB
references/type-state.mdmarkdown1.1 KB
references/type-story-map.mdmarkdown4.7 KB
# Diagram Design Skill

## Description

Creates editorial technical and product diagrams as standalone HTML with inline SVG and CSS. It supports branded architecture diagrams, flowcharts, sequence diagrams, data models, timelines, charts, and other structured visual formats. It can also redraw Mermaid and draw.io sources for a specific audience, size, and level of detail.

## Usage examples

- "Create an editorial architecture diagram of this service as standalone HTML."
- "Redraw this Mermaid sequence diagram for a 16:9 engineering presentation."
- "Create a branded database schema diagram using my saved client profile."
- "Turn this draw.io system map into a simplified executive diagram."

For Mermaid-as-code, themed Mermaid rendering, ASCII output, or batch rendering, use [`pretty-mermaid`](../pretty-mermaid/) instead.

## Installation scope

This directory vendors the upstream `skills/diagram-design/` subtree plus the local patch documented below. It does not include the upstream Pi prompt templates, so `/export-diagram`, `/import-mermaid`, `/profile`, and `/doctor` are not installed as standalone commands. Invoke `/skill:diagram-design` and request those workflows in natural language instead.

Keep the committed vendor snapshot unchanged. Store custom styles in `~/.diagram-design/profiles/` and select a profile from a project-level `.diagram-design` marker as described in [`references/profiles.md`](references/profiles.md).

Upstream onboarding temporarily writes `references/style-guide.md` before saving a profile. After onboarding saves the profile and adds the project marker, restore the committed working copy from the `coding-harness` repository root:

```bash
git restore --source=HEAD -- skills/diagram-design/references/style-guide.md
git status --short -- skills/diagram-design
```

The status command should produce no output. The project marker then reads the saved profile directly without modifying the installed working copy.

## Origin

- Upstream skill: [`skills/diagram-design/`](https://github.com/cathrynlavery/diagram-design/tree/main/skills/diagram-design)
- Upstream repository: [cathrynlavery/diagram-design](https://github.com/cathrynlavery/diagram-design)
- Live gallery: [cathrynlavery.github.io/diagram-design](https://cathrynlavery.github.io/diagram-design/)
- Vendored upstream commit: [`648c2a597839301e06df1e7434a08bde9f42eed3`](https://github.com/cathrynlavery/diagram-design/commit/648c2a597839301e06df1e7434a08bde9f42eed3)

## Credits

- Original author and maintainer: **Cathryn Lavery**
- Local packaging and documentation: `coding-harness`

## License

The upstream skill is distributed under the MIT License. See [`LICENSE`](LICENSE) for the retained notice and [`THIRD_PARTY_LICENSES.md`](THIRD_PARTY_LICENSES.md) for bundled asset attribution.

## Local patch

[`local-patches/playwright-chromium-discovery.patch`](local-patches/playwright-chromium-discovery.patch) adds a packaged PNG exporter that discovers:

1. Python Playwright in the active interpreter, project virtual environments, or another Python on `PATH`.
2. Playwright-managed Chromium.
3. A browser named by `DIAGRAM_DESIGN_CHROMIUM`.
4. Chrome, Chromium, or Edge in standard system locations.

The exporter never installs packages or downloads browsers. Run its unit tests with:

```bash
PYTHONDONTWRITEBYTECODE=1 python3 scripts/test_export_png.py
```

## Update from upstream

Updates are manual so each upstream change can be reviewed. From the `coding-harness` repository root, run:

```bash
set -euo pipefail

repo_root=$(git rev-parse --show-toplevel)
target="$repo_root/skills/diagram-design"
if [ -n "$(git -C "$repo_root" status --porcelain -- skills/diagram-design)" ]; then
  echo "Commit or restore local diagram-design changes before updating." >&2
  exit 1
fi

tmp=$(mktemp -d)
trap 'rm -rf "$tmp"' EXIT

git clone --depth 1 --filter=blob:none --sparse \
  --branch main --single-branch \
  https://github.com/cathrynlavery/diagram-design.git \
  "$tmp/upstream"
git -C "$tmp/upstream" sparse-checkout set skills/diagram-design

rsync -a --delete \
  --exclude README.md \
  --exclude LICENSE \
  --exclude THIRD_PARTY_LICENSES.md \
  --exclude local-patches/ \
  "$tmp/upstream/skills/diagram-design/" \
  "$target/"
cp "$tmp/upstream/LICENSE" "$target/LICENSE"
cp "$tmp/upstream/THIRD_PARTY_LICENSES.md" "$target/THIRD_PARTY_LICENSES.md"

rsync -ainc --delete \
  --exclude README.md \
  --exclude LICENSE \
  --exclude THIRD_PARTY_LICENSES.md \
  --exclude local-patches/ \
  "$tmp/upstream/skills/diagram-design/" \
  "$target/"

git -C "$repo_root" apply --check \
  "$target/local-patches/playwright-chromium-discovery.patch"
git -C "$repo_root" apply \
  "$target/local-patches/playwright-chromium-discovery.patch"

PYTHONDONTWRITEBYTECODE=1 python3 "$target/scripts/test_export_png.py"
python3 "$target/scripts/self_check.py" \
  "$target/assets/example-flowchart.html"
printf '%s\n' 'flowchart LR' '    A[Start] --> B[End]' \
  > "$tmp/sample.mmd"
python3 "$target/scripts/mermaid_extract.py" "$tmp/sample.mmd"
python3 "$target/scripts/drawio_extract.py" --help >/dev/null

git -C "$tmp/upstream" rev-parse HEAD
```

The checksum-mode `rsync` command should produce no output, the local patch must apply cleanly, and the discovery tests and smoke checks should pass. If `git apply --check` fails, restore the committed snapshot and rebase the local patch against the new upstream commit; do not force-apply it.

Replace the vendored commit in this README with the printed commit hash, then inspect the update:

```bash
git diff --check
git diff -- skills/diagram-design
```

If the update should not be retained, restore the previously committed snapshot:

```bash
git restore --source=HEAD -- skills/diagram-design
```
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall