What is design-doc-mermaid?
design-doc-mermaid is a Claude skill by spillwavesolutions that create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code. Default for GitHub wiki. Use when asked to create a diagram, generate mermaid,. It is listed under Design & UI and has 177 GitHub stars.
| Type | Claude skill |
|---|---|
| Author | spillwavesolutions |
| Repository | spillwavesolutions/design-doc-mermaid |
| Popularity | 177 GitHub stars |
| Category | Design & UI |
| Security | Low risk (96/100) |
| Rank | #874 of 1,262 Claude skills; #109 in Design & UI |
| SKILL.md length | 519 lines |
| Last commit | 2026-08-24 |
| Stars this week | +1 |
| Installs in the last 24h | 1,200 |
Is design-doc-mermaid safe to install?
design-doc-mermaid scores 96/100 on the MCPMods security check: Low risk. No checks raised a concern. It passed 8 of 9 checks.
Skill results come from a static scan of its SKILL.md for instruction overrides, hidden actions, risky commands and credential access.
| Check | Result |
|---|---|
| No instruction-override phrases | Pass |
| No hidden actions | Pass |
| No pipe-to-shell installers | Pass |
| No obfuscated code | Pass |
| No destructive commands | Pass |
| Doesn't ask for keys or credentials | Pass |
| No network requests | Pass |
| Runs shell commands | Note |
| Installs no packages | Pass |
What the scan matched
- shell:
```bash - scripts:
scripts/extract_mermaid.py
How do I install design-doc-mermaid?
- Install with the skills CLI. Works for Claude Code and other agents that read skills.
npx skills add https://github.com/spillwavesolutions/design-doc-mermaid --skill design-doc-mermaid
- Or copy it by hand. Claude Code loads any folder with a SKILL.md from ~/.claude/skills.
git clone https://github.com/spillwavesolutions/design-doc-mermaid cp -r design-doc-mermaid/design-doc-mermaid ~/.claude/skills/design-doc-mermaid
- Use it. Claude loads the skill when a task matches its description. You can also name it in your prompt.
Use the design-doc-mermaid skill to …
Or ask Claude to set it up
Paste this into Claude Code and it installs design-doc-mermaid for you:
Install the "design-doc-mermaid" skill from https://github.com/spillwavesolutions/design-doc-mermaid into ~/.claude/skills, then tell me in one line what it does.