d2 SKILL.md skillA

d2 from devskale/skale-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add devskale/skale-skills/d2@v1.4.1

Pins v1.4.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
devskale/skale-skills
Path
skills/d2/SKILL.md
Versions recorded
7
Latest version
v1.4.1, committed Oct 2, 2026
First version recorded
Aug 9, 2026
Size
4,987 bytes
Repository stars
2
License
none declared

Draw architecture, sequence, flowchart, or ER diagrams as code with the D2 CLI. Use when the user wants to create, edit, validate, or render any diagram or .d2 file.

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

# D2 — Diagrams as Code

> **Manual only** — invoke explicitly with `/skill:d2`; the agent won't reach for it on its own.

D2 turns text into diagrams. **Knowledge skill** — the agent drives the `d2` CLI directly; `scripts/` only adds thin wrappers. Requires `brew install d2`.

> **Ecosystem:** hand-drawn presentation figures (sketchy look, manual layout) → **`figure`** ·
> shareable page/report (one HTML + URL) → **`visualize`** · `d2` = auto-laid-out technical
> diagrams (sequence, ER, class, many types) with ASCII self-verification.

## Install

```bash
openskills install devskale/skale-skills/skills/d2   # → pi, claude, opencode, …
```
Or clone + add to pi config: `"skills": ["~/code/skale-skills/skills/d2"]` in `~/.pi/agent/settings.json`.

## Quick Start — the render loop

```bash
bash scripts/d2v diagram.d2          # ONE command: validate → ASCII to stderr → svg → width-bloat check
bash scripts/d2v diagram.d2 -- --sketch --theme 4   # forward flags to d2 (sketch/themes — sketch is CLI-only, vars ignore it)
bash scripts/d2png diagram.d2        # PNG via rsvg-convert (no Playwright/Chromium download)
# (the raw loop it runs, if you need the pieces:)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add devskale/skale-skills/d2@sha256:c4d1fe82009bc7cc

The line at the top of this page pins the label v1.4.1, 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_ol7hbmshofstocok.svg)](https://markdownregistry.com/a/art_ol7hbmshofstocok)

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

Versions

The registry has recorded 7 versions of this file, between Aug 9, 2026 and Oct 2, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
v1.4.1 latest2026-10-02 b0e08b0 4,987 BA view · diff
v1.4.12026-09-17 fc75cf8 5,263 BA view · diff
v1.4.02026-09-08 12dfa11 13,432 BA view · diff
v1.4.02026-08-12 229415e 13,350 BA view · diff
v1.4.02026-08-12 9b10468 13,015 BA view · diff
v1.4.02026-08-09 24b3db3 12,824 BA view · diff
v1.4.02026-08-09 c64a535 12,748 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 (4987 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

devskale/skale-skills · 2 stars · license none declared · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ol7hbmshofstocok
GET https://markdownregistry.com/api/v1/resolve?ref=devskale/skale-skills/d2
GET https://markdownregistry.com/api/v1/blob/c4d1fe82009bc7cc5caab1809d1ec2ac9fa22a4d16fa89d0dd26e91c925db066

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 devskale/skale-skills

AGENTS.md AGENTS.md file
devskale/skale-skills · AGENTS.md
git:20261101.29431fb · audit A · 2 stars
agent-skill-creator SKILL.md skill
devskale/skale-skills · deprecated/agent-skill-creator/SKILL.md · Guide for creating effective skills for any AI agent (Claude, Trae, Gemini, OpenCode, Qwen, etc.). This skill should be…
git:20261006.3723cb2 · audit A · 2 stars
agents-md-init SKILL.md skill
devskale/skale-skills · deprecated/agents-md-init/SKILL.md · Create and update concise AGENTS.md files using proven best practices. Use when starting a new AGENTS.md, refactoring…
git:20261006.3723cb2 · audit A · 2 stars
command-creator SKILL.md skill
devskale/skale-skills · deprecated/command-creator/SKILL.md · Create custom commands for Pi (prompt templates) or OpenCode. Define command prompts, arguments, shell output…
v2.0.0 · audit A · 2 stars
improve-skill SKILL.md skill
devskale/skale-skills · deprecated/improve-skill/SKILL.md · Analyze coding agent session transcripts to improve existing skills or create new ones. Use when asked to improve a…
git:20261006.3723cb2 · audit A · 2 stars
readme-write SKILL.md skill
devskale/skale-skills · deprecated/readme-write/SKILL.md · Create and update README.md files with proper structure, badges, and sections.
git:20261006.3723cb2 · audit A · 2 stars
todo SKILL.md skill
devskale/skale-skills · deprecated/todo/SKILL.md · Create and manage TODO.md task tracking files for complex multi-step work. Use when starting a larger task that…
git:20261006.3723cb2 · audit A · 2 stars
viewimg SKILL.md skill
devskale/skale-skills · deprecated/viewimg/SKILL.md · DEPRECATED — use `read img.jpg` or `read_image` instead. Display an image in the terminal (view-only, no VLM). Renders…
v0.1.0 · audit A · 2 stars
fetch-url SKILL.md skill
devskale/skale-skills · skills/fetch-url/SKILL.md · Bash skill — run `fetch-url "url"` in your shell (not an MCP tool). Fetch and extract readable text from any web page…
v2.9.1 · audit A · 2 stars
figure SKILL.md skill
devskale/skale-skills · skills/figure/SKILL.md · Draw hand-drawn-style architecture or workflow figures (sketchy Excalidraw look) as SVG + PNG from a small .fig.mjs…
v1.2.1 · audit A · 2 stars
improve-ux SKILL.md skill
devskale/skale-skills · skills/improve-ux/SKILL.md · Improve UI/UX grounded in curated reference sites, with a ratings loop and findings ledger. Use when polishing a…
v0.4.0 · audit A · 2 stars
issues SKILL.md skill
devskale/skale-skills · skills/issues/SKILL.md · Manage the cross-machine shared issue kanban (works/<project>/issues/). Create, triage, start, review, cancel, archive…
v1.5.1 · audit A · 2 stars

Every file in devskale/skale-skills

Other files named d2

d2 SKILL.md skill
antoinebou12/uml-mcp · .skill/skills/d2/SKILL.md · Writes valid d2 diagram source for uml-mcp (diagram_type=d2). A modern diagram scripting language Use when the user…
git:20261023.634e385 · audit A · 109 stars

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