utility-mermaid-diagrams SKILL.md skillA
utility-mermaid-diagrams from product-on-purpose/pm-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add product-on-purpose/pm-skills/utility-mermaid-diagrams@v1.1.0Pins v1.1.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- product-on-purpose/pm-skills
- Path
skills/utility-mermaid-diagrams/SKILL.md- Versions recorded
- 5
- Latest version
- v1.1.0, committed Jul 6, 2026
- First version recorded
- Apr 8, 2026
- Size
- 6,498 bytes
- Repository stars
- 790
- License
- Apache-2.0
Teaches PMs to create syntactically valid mermaid diagrams by selecting the right diagram type for their communication need, following syntax validity rules, and validating before shipping. Covers all 15 mermaid diagram types with PM-relevant examples and a dual-lens navigation system.
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
<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 --> # Mermaid Diagrams Create effective, syntactically valid mermaid diagrams for product documents. ## When to Use - Creating mermaid diagrams for PRDs, specs, roadmaps, or stakeholder presentations - Choosing which of 15 diagram types fits a specific communication need - Debugging mermaid code that won't render or renders incorrectly - Reviewing diagrams for clarity, accuracy, and accessibility ## When NOT to Use - Exporting diagrams to image files (PNG/SVG) - that's a rendering tool concern - Using non-mermaid diagramming tools (Figma, Lucidchart, draw.io) - Creating purely decorative visuals with no informational purpose - Producing a full customer-journey artifact (stages, touchpoints, emotional curve, pain points) rather than a standalone diagram - use `discover-journey-map`, which composes this skill for its timeline or flowchart section ## The Cardinal Rule > Don't diagram what a list can say. Diagrams earn their place when they reveal **relationships**, **branching**, or **flow** that prose flattens. Before creating any diagram, ask: …
Read the whole file at its exact version.
How to install
mdr add product-on-purpose/pm-skills/utility-mermaid-diagrams@sha256:aeb8d8462f02be1cThe line at the top of this page pins the label v1.1.0, 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_y5qsb73whfyvrs4w)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Apr 8, 2026 and Jul 6, 2026, about one every 22 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.1.0 latest | 2026-07-06 | fa0111e | 6,498 B | A | view · diff |
| v1.0.0 | 2026-06-10 | b8ccff6 | 6,274 B | A | view · diff |
| v1.0.0 | 2026-05-20 | be1352b | 6,274 B | A | view · diff |
| v1.0.0 | 2026-04-23 | 8ab0f81 | 6,268 B | A | view · diff |
| v1.0.0 | 2026-04-08 | 06af8fb | 6,308 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 (6498 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
product-on-purpose/pm-skills · 790 stars · license Apache-2.0 · pushed 2026-11-03 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_y5qsb73whfyvrs4w GET https://markdownregistry.com/api/v1/resolve?ref=product-on-purpose/pm-skills/utility-mermaid-diagrams GET https://markdownregistry.com/api/v1/blob/aeb8d8462f02be1ca2fc474a0b14025fe6d3213c6a2c3d795a6ca29f924b985a
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.