diagram-design SKILL.md skillA

diagram-design from cathrynlavery/diagram-design is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add cathrynlavery/diagram-design/diagram-design@v2.6

Pins v2.6 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
cathrynlavery/diagram-design
Path
skills/diagram-design/SKILL.md
Versions recorded
28
Latest version
v2.6, committed Oct 27, 2026
First version recorded
Sep 6, 2026
Size
30,874 bytes
Repository stars
63,949
License
MIT

Create branded architecture, architecture delta, 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, exploded axonometric, axonometric plan, Venn, pyramid/funnel, treemap and marimekko, heatmap, bar and dumbbell, waterfall, line (slopegraph, ridgeline, streamgraph, bump), Gantt and scatter charts (bubble, beeswarm, box plot), high-level…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Diagram Design

Create diagrams as self-contained HTML files with inline SVG and an editorial design system.

Forty-five visual types. Semantic patterns describe behavior; type references describe layout.

---

## 0. First-time setup — style guide gate

**Before generating your first diagram in a new project, verify the style guide has been customized.**

Do not silently ship default-skinned diagrams into a branded project.

First resolve any project `.diagram-design` marker per [`references/profiles.md`](references/profiles.md); a successfully resolved marker selects its profile and bypasses this gate. That reference owns failures, the protected default, and save behavior.

Open [`references/style-guide.md`](references/style-guide.md) and check the default tokens. If they are still the shipped defaults (paper `#f5f5f5`, ink `#2d3142`, accent `#bf4520`), **pause and ask the user**:

> *"This is your first diagram in this project and the style guide is still default. Customize now? Options: (a) website URL, (b) installed skill, (c) local folder/design-system, (d) paste tokens, (e) keep default, (f) load saved profile."*
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add cathrynlavery/diagram-design/diagram-design@sha256:83fd5aa46965ce2b

The line at the top of this page pins the label v2.6, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_hg22cjnv3ua4cviz.svg)](https://markdownregistry.com/a/art_hg22cjnv3ua4cviz)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 28 versions of this file, between Sep 6, 2026 and Oct 27, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
v2.6 latest2026-10-27 7bf9445 30,874 BA view · diff
v2.62026-10-25 d35ae86 30,821 BA view · diff
v2.62026-10-25 d0e57dc 30,798 BA view · diff
v2.62026-10-19 3ed3864 30,798 BA view · diff
v2.62026-10-16 8e49f5e 30,799 BA view · diff
v2.62026-10-15 5695d3d 30,743 BA view · diff
v2.62026-10-13 a3af885 30,778 BA view · diff
v2.62026-10-13 1a6a6fc 30,753 BA view · diff
v2.62026-10-12 9dcaff8 30,725 BA view · diff
v2.62026-10-09 14f95e2 30,519 BA view · diff
v2.62026-10-05 da7cd27 30,098 BA view · diff
v2.62026-10-05 d86805d 29,900 BA view · diff
v2.62026-10-01 e61773a 29,706 BA view · diff
v2.62026-10-01 643cd8f 29,587 BA view · diff
v2.62026-09-28 ea5019e 29,320 BA view · diff
v2.62026-09-28 0953f12 29,147 BA view · diff
v2.62026-09-28 91e774a 28,869 BA view · diff
v2.62026-09-27 da6c92c 39,530 BA view · diff
v2.62026-09-19 5611733 39,506 BA view · diff
v2.62026-09-18 76557be 39,219 BA view · diff
v2.62026-09-18 ec9a405 39,171 BA view · diff
v2.62026-09-15 b26918f 39,085 BA view · diff
v2.62026-09-15 92ca029 39,077 BA view · diff
v2.62026-09-15 a1e8a9a 39,948 BA view · diff
v2.62026-09-10 899579b 39,951 BA view · diff
v2.62026-09-09 48feccc 39,964 BA view · diff
v2.62026-09-07 d0a0f46 39,989 BA view · diff
v2.62026-09-06 8ed7724 39,996 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (30874 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

cathrynlavery/diagram-design · 63,949 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hg22cjnv3ua4cviz
GET https://markdownregistry.com/api/v1/resolve?ref=cathrynlavery/diagram-design/diagram-design
GET https://markdownregistry.com/api/v1/blob/83fd5aa46965ce2b14bd42ade80c065a4e17a9f83d2a9f4f275b47cd45d72666

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from cathrynlavery/diagram-design

AGENTS.md AGENTS.md file
cathrynlavery/diagram-design · AGENTS.md
git:20261021.1c8a664 · audit A · 63,949 stars
CLAUDE.md CLAUDE.md file
cathrynlavery/diagram-design · CLAUDE.md
git:20261021.1c8a664 · audit B · 63,949 stars

Every file in cathrynlavery/diagram-design

Other files named diagram-design

diagram-design SKILL.md skill
anbeime/skill · skills/diagram-design/skills/diagram-design/SKILL.md · Create branded architecture, architecture delta, IT current-state, flowchart, sequence, state machine, ER/data model…
v2.6 · audit A · 9,097 stars
diagram-design SKILL.md skill
akillness/jeo-skills · .agent-skills/diagram-design/SKILL.md · Use when creating source-grounded branded diagrams with cathrynlavery/diagram-design: run its offline preflight, choose…
v1.0.0 · audit A · 53 stars
diagram-design SKILL.md skill
vecnode/vn-code · packages/dsh-diagrams/skills/diagram-design/SKILL.md · Author an editorial HTML+SVG diagram with the Diagram Design kit - choose the visual type, read its reference, start…
git:20261011.90817e1 · audit B · 10 stars
diagram-design SKILL.md skill
vecnode/vncode · packages/dsh-diagrams/skills/diagram-design/SKILL.md · Author an editorial HTML+SVG diagram with the Diagram Design kit - choose the visual type, read its reference, start…
git:20261011.90817e1 · audit B · 10 stars
diagram-design SKILL.md skill
vanducng/skills · skills/diagram-design/SKILL.md · Create polished, accessible, self-contained HTML/SVG diagrams for architecture, deployment, dependency graphs…
v1.1.0 · audit A · 8 stars
diagram-design SKILL.md skill
dannykkh/skill-olympus · skills/diagram-design/SKILL.md · 에디토리얼 품질 다이어그램 표현 계층. 파이프라인 .mmd(flowchart/sequence/state/ER) 또는 자연어 설명을 브랜드 토큰 기반 self-contained HTML + inline SVG로…
git:20260901.8bc747e · audit A · 7 stars
diagram-design SKILL.md skill
coolxeo/grok-bot-skills · skills/design/diagram-design/SKILL.md · use this when creating explainer diagrams (architecture, sequence, process, cards for posts) as HTML/SVG/PNG so they…
git:20261010.3ba1fbe · audit A · 7 stars
diagram-design SKILL.md skill
jensen-yao/agents-skills · skills/diagram-design/SKILL.md · Create branded architecture, architecture delta, IT current-state, flowchart, sequence, state machine, ER/data model…
v2.6 · audit A · 5 stars

Browse by kind, by grade A, or by owner.