Install any skill in seconds. Free to start, no credit card required.
Get Started Free →mkurman/markdown-mermaid-writing
Comprehensive markdown and Mermaid diagram writing skill.
Passed 22 of 22 test cases with the skill, and 11 of 22 without it.
and 14 more in the full report
11 fixed11 passed either way0 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 11 test cases the skill fixed. Same model, same prompt, with and without the skill.
Draft a Mermaid spider visual diagram comparing three cloud storage providers across durability, latency, and cost dimensions. Configure the axes and series syntax for modern rendering engines.
| Checked | Without skill | With skill |
|---|---|---|
| Uses radar-beta as the top-level diagram keyword. | Missed | Passed |
| Defines dimension categories using the axis keyword. | Missed | Passed |
| Defines visual series using the curve keyword. | Missed | Passed |
The instructions your model reads when the skill loads.
----------------------- | :-----------------: | :---------------: | | Git diff readable | ✅ | ❌ binary blob | | Editable without regenerating | ✅ | ❌ | | Token efficient vs. prose | ✅ smaller | ❌ larger | | Renders without a build step | ✅ | ❌ needs hosting | | Parseable by AI without vision | ✅ | ❌ | | Works in GitHub / GitLab / Notion | ✅ | ⚠️ if hosted | | Accessible (screen readers) | ✅ accTitle/accDescr | ⚠️ needs alt text | | Convertible to image later | ✅ anytime | — already image |
flowchart LR
accTitle: Three-Phase Documentation Workflow
accDescr: Phase 1 Mermaid in markdown is always required and is the source of truth. Phases 2 and 3 are optional downstream conversions for polished output.
p1["📄 Phase 1<br/>Mermaid in Markdown<br/>(ALWAYS — source of truth)"]
p2["🐍 Phase 2<br/>Python Generated<br/>(optional — data charts)"]
p3["🎨 Phase 3<br/>AI Generated Visuals<br/>(optional — polish)"]
out["📊 Final Deliverable"]
p1 --> out
p1 -.->|"when needed"| p2
p1 -.->|"when needed"| p3
p2 --> out
p3 --> out
classDef required fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#1e3a5f
classDef optional fill:#fef9c3,stroke:#ca8a04,stroke-width:2px,color:#713f12
classDef output fill:#dcfce7,stroke:#16a34a,stroke-width:2px,color:#14532d
class p1 required
class p2,p3 optional
class out output
Phase 1 is mandatory. Even if you proceed to Phase 2 or 3, the Mermaid source stays committed.
test cases passed, vs 11 / 22 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.