make-diagram SKILL.md skillA

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

Install it, pinned
mdr add checkpickerupper/skills/make-diagram@git:20261021.61c15fb

Pins git:20261021.61c15fb in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
checkpickerupper/skills
Path
skills/productivity/make-diagram/SKILL.md
Versions recorded
5
Latest version
git:20261021.61c15fb, committed Oct 21, 2026
First version recorded
Oct 14, 2026
Size
11,891 bytes
Repository stars
6
License
MIT

Draw or revise any diagram for a reader: system map, flowchart, pipeline, process map, decision flow, architecture. Use whenever a diagram goes into an Artifact, doc, issue, PR or repository, and on every revision after the owner corrects one. Settles the domain and the plain words before drawing, puts rulebooks in tables, shows the mechanism as nodes, diamonds and lanes in a fixed SVG vocabulary, and ships a checker that renders light and dark images and refuses overlaps, small text, crammed…

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

# Make a diagram

A diagram shows a stranger a mechanism they would otherwise assemble from
prose: what comes in, what checks it, where each path goes. This skill owns the
drawing. On an Artifact page, `make-artifact` owns the page around it and
`artifact-diagramming` owns the inline-SVG mechanics (viewBox sizing, markers,
a self-contained `<svg>`). Where they differ, this skill wins: text is 15px or
larger, and the figure carries no caption.

## 1. Settle the domain

<what-to-do>
- List every node you mean to draw beside the source of its fact: the owner's
  words, a file, an issue, a page. A node with no source is a guess.
- Ask the owner when a flow is ambiguous (which source settles it, what happens
  when a check fails, who pays), using the client's question tool where it has
  one. Specifics come only from a source: no trial lengths, sample sizes,
  prices or timings that nobody gave you.
- Use the domain's real names. Codenames, placeholders and names the owner
  calls undecided stay off the drawing.
- Write words a stranger understands, naming what the thing does: "copy
  official stats", "sportsbooks", "what settles it", in place of internal terms
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add checkpickerupper/skills/make-diagram@sha256:7b475ee6db17b345

The line at the top of this page pins the label git:20261021.61c15fb, 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_ionxf74lqn6rl2pa.svg)](https://markdownregistry.com/a/art_ionxf74lqn6rl2pa)

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

Versions

The registry has recorded 5 versions of this file, between Oct 14, 2026 and Oct 21, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261021.61c15fb latest2026-10-21 61c15fb 11,891 BA view · diff
git:20261019.00a1c462026-10-19 00a1c46 11,806 BA view · diff
git:20261019.5dbf5ab2026-10-19 5dbf5ab 10,628 BA view · diff
git:20261014.e32cf072026-10-14 e32cf07 8,340 BA view · diff
git:20261014.6b0642e2026-10-14 6b0642e 7,826 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 (11891 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

checkpickerupper/skills · 6 stars · license MIT · pushed 2026-10-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ionxf74lqn6rl2pa
GET https://markdownregistry.com/api/v1/resolve?ref=checkpickerupper/skills/make-diagram
GET https://markdownregistry.com/api/v1/blob/7b475ee6db17b345985d59c939f0a22b0baf5be089914e28f8feb40a4cc9763b

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 checkpickerupper/skills

grill-with-docs-requiem SKILL.md skill
checkpickerupper/skills · skills/deprecated/grill-with-docs-requiem/SKILL.md · A high-judgment design interview that sharpens plans in useful batches and records settled domain language and ADRs as…
git:20261012.0a0453b · audit A · 6 stars
antimatter-code-quality-review SKILL.md skill
checkpickerupper/skills · skills/engineering/antimatter-code-quality-review/SKILL.md · Deep code-quality and pre-merge review of a commit, PR, branch, or diff. Audit correctness, intent, naming, cohesion…
git:20261021.61c15fb · audit A · 6 stars
antimatter-codebase-structure-review SKILL.md skill
checkpickerupper/skills · skills/engineering/antimatter-codebase-structure-review/SKILL.md · Pedantic structural audit of a commit, PR or branch, selected directory or module, or an entire codebase — hierarchy…
git:20261021.61c15fb · audit A · 6 stars
explain-diff SKILL.md skill
checkpickerupper/skills · skills/engineering/explain-diff/SKILL.md · Explain a code change, diff, branch, commit, or PR as a rich, self-contained page: background, intuition with concrete…
git:20261021.61c15fb · audit B · 6 stars
pizza1 SKILL.md skill
checkpickerupper/skills · skills/engineering/pizza1/SKILL.md · Justify by correctness, never by convention. Use when a design, fix, API, macro, library surface, hook message, or…
git:20261021.61c15fb · audit A · 6 stars
readonly SKILL.md skill
checkpickerupper/skills · skills/engineering/readonly/SKILL.md · User-invoked modifier for evidence-first read-only investigation. Use when the user appends /readonly to a question or…
git:20261021.61c15fb · audit A · 6 stars
zen-of-checkpickerupper SKILL.md skill
checkpickerupper/skills · skills/engineering/zen-of-checkpickerupper/SKILL.md · The Zen of CheckPickerUpper: twenty-one lines that judge designs, fixes, abstractions, types, structure, and questions…
git:20261021.61c15fb · audit A · 6 stars
agent-mdlint SKILL.md skill
checkpickerupper/skills · skills/in-progress/agent-mdlint/SKILL.md · Review AGENTS.md changes for Markdown defects, duplicated or conflicting instructions, and unintended semantic drift…
git:20261021.98508ae · audit A · 6 stars
build-vs-buy SKILL.md skill
checkpickerupper/skills · skills/in-progress/build-vs-buy/SKILL.md · Before implementing a new capability, service, subsystem, or integration, choose its owner—reuse, adopt, buy, build…
git:20261021.98508ae · audit A · 6 stars
correct-by-construction SKILL.md skill
checkpickerupper/skills · skills/in-progress/correct-by-construction/SKILL.md · Make classes of invalid states and evaded constraints unreachable by type composition first. Use for bugs, bad APIs…
git:20261021.98508ae · audit A · 6 stars
make-artifact SKILL.md skill
checkpickerupper/skills · skills/in-progress/make-artifact/SKILL.md · Make, revise, or republish a claude.ai Artifact of any kind: report, audit, decision page, dashboard, tracker, form…
git:20261021.98508ae · audit A · 6 stars
pressure-test-this SKILL.md skill
checkpickerupper/skills · skills/in-progress/pressure-test-this/SKILL.md · Adversarial stress-test of an architecture, technical proposal, API contract, state machine, or plan before…
git:20261021.98508ae · audit A · 6 stars

Every file in checkpickerupper/skills

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