utility-mermaid-diagrams
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.
npx skills add product-on-purpose/pm-skills --skill utility-mermaid-diagrams --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
<!-- 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: *Does this show branching, relationships, or flow that a list o
- When to Use
- When NOT to Use
- The Cardinal Rule
- Diagram Selection Guide
- Syntax Validity Principles
- Instructions
- Output Contract
- Quality Checklist
- References
What does the utility-mermaid-diagrams skill do?
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.
How do I install it?
Run `npx skills add product-on-purpose/pm-skills --skill utility-mermaid-diagrams --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From product-on-purpose/pm-skills, a repository with 518 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.