markdown-mermaid-writing SKILL.md skillA
markdown-mermaid-writing from foryourhealth111-pixel/vibe-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add foryourhealth111-pixel/vibe-skills/markdown-mermaid-writing@git:20260303.491ea97Pins git:20260303.491ea97 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- foryourhealth111-pixel/vibe-skills
- Path
bundled/skills/markdown-mermaid-writing/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260303.491ea97, committed Mar 3, 2026
- Size
- 15,135 bytes
- Repository stars
- 3,805
- License
- Apache-2.0
Comprehensive markdown and Mermaid diagram writing skill that establishes text-based diagrams as the DEFAULT documentation standard. Use this skill when creating ANY scientific document, report, analysis, or visualization — it ensures all outputs are in version-controlled, token-efficient markdown with embedded Mermaid diagrams as the source of truth, with clear pathways to downstream Python or AI-generated images. Includes full style guides (markdown + mermaid), 24 diagram type references…
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
# Markdown and Mermaid Writing ## Overview This skill teaches you — and enforces a standard for — creating scientific documentation using **markdown with embedded Mermaid diagrams as the default and canonical format**. The core bet: a relationship expressed as a Mermaid diagram inside a `.md` file is more valuable than any image. It is text, so it diffs cleanly in git. It requires no build step. It renders natively on GitHub, GitLab, Notion, VS Code, and any markdown viewer. It uses fewer tokens than a prose description of the same relationship. And it can always be converted to a polished image later — but the text version remains the source of truth. > "The more you get your reports and files in .md in just regular text, which mermaid is > as well as being a simple 'script language'. This just helps with any downstream rendering > and especially AI generated images (using mermaid instead of just long form text to > describe relationships < tokens). Additionally mermaid can render along with markdown for > easy use almost anywhere by humans or AI." > > — Clayton Young (@borealBytes), K-Dense Discord, 2026-02-19 ## When to Use This Skill Use this skill when: …
Read the whole file at its exact version.
How to install
mdr add foryourhealth111-pixel/vibe-skills/markdown-mermaid-writing@sha256:69742dd138cff629The line at the top of this page pins the label git:20260303.491ea97, 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_x6hb3e4q3xquwzrx)
7 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Mar 3, 2026.
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 (15135 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
foryourhealth111-pixel/vibe-skills · 3,805 stars · license Apache-2.0 · pushed 2026-11-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_x6hb3e4q3xquwzrx GET https://markdownregistry.com/api/v1/resolve?ref=foryourhealth111-pixel/vibe-skills/markdown-mermaid-writing GET https://markdownregistry.com/api/v1/blob/69742dd138cff629da041d4c4d7596e48eaad2633cb94a1f81eadaf35248c295
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 foryourhealth111-pixel/vibe-skills
Every file in foryourhealth111-pixel/vibe-skills