mermaid-diagrams SKILL.md skillA
mermaid-diagrams from vecnode/vncode is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add vecnode/vncode/mermaid-diagrams@git:20260930.b3a6a0dPins git:20260930.b3a6a0d in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- vecnode/vncode
- Path
packages/dsh-diagrams/skills/mermaid-diagrams/SKILL.md- Versions recorded
- 5
- Latest version
- git:20260930.b3a6a0d, committed Sep 30, 2026
- First version recorded
- Sep 20, 2026
- Size
- 13,939 bytes
- Repository stars
- 10
- License
- AGPL-3.0
Author Mermaid diagrams that parse the first time: choose the right diagram type for the question, write syntax the parser accepts, and keep the picture readable in a narrow panel. A bundled reference covers complex, large diagrams.
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
# Mermaid diagrams
You are writing Mermaid for the **`diagram_write`** tool of this harness. Every
write is parsed on the host before it is stored, and the parse verdict comes
back to you with the offending line. Treat that as the loop:
```
diagram_write { kind: "mermaid", title: "Auth flow", source: "..." }
-> status "ok" : it parses; it is already rendering in the conversation
-> status "error" : fix the line named in `diagnostics` and write again
-> status "unavailable" : the validator could not run; the diagram is stored,
but you have NOT verified it - say so to the user
```
Rules that matter:
- **Never finish on a non-`ok` status.** A diagram the user cannot see is a failed call.
- **One diagram per question.** Several small diagrams beat one 60-node picture.
- Iterate a long diagram with **`diagram_patch`** (literal replace) instead of
re-emitting all of it; re-read with **`diagram_read`** if your context may have
been compacted.
- The returned `address` (`dsh-resource://diagram/session/<session>/<id>`) is the
tab that shows the picture; the id is a readable slug derived from the title.
…Read the whole file at its exact version.
How to install
mdr add vecnode/vncode/mermaid-diagrams@sha256:3354abcc320a4587The line at the top of this page pins the label git:20260930.b3a6a0d, 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.
[](https://markdownregistry.com/a/art_x22nfno32heyfinj)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Sep 20, 2026 and Sep 30, 2026, about one every 2 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260930.b3a6a0d latest | 2026-09-30 | b3a6a0d | 13,939 B | A | view · diff |
| git:20260920.25904b4 | 2026-09-20 | 25904b4 | 13,943 B | A | view · diff |
| git:20260920.94547e9 | 2026-09-20 | 94547e9 | 13,134 B | A | view · diff |
| git:20260920.1295337 | 2026-09-20 | 1295337 | 11,837 B | A | view · diff |
| git:20260920.e4eee90 | 2026-09-20 | e4eee90 | 8,830 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (13939 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
vecnode/vncode · 10 stars · license AGPL-3.0 · pushed 2026-10-20 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_x22nfno32heyfinj GET https://markdownregistry.com/api/v1/resolve?ref=vecnode/vncode/mermaid-diagrams GET https://markdownregistry.com/api/v1/blob/3354abcc320a45879afc881fc452ae235738639a839699a57e8ad8860e69c349
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.