09-mermaid — Claude Code skill: plan, generate
09-mermaid turns a written description of an architecture or a flow into a Mermaid diagram, with a plan you approve before anything gets drawn.
MIT ★ 571 updated 2026-10-29
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-context@aidd-frameworkWhat 09-mermaid does
Hand it a written source: a description of an architecture, a lifecycle or a flow. It drafts a plan first. Then it waits for your confirmation, generates the diagram and offers a review. Nothing you did not approve shows up as a node or a link.
The skill holds one action, mermaid, under actions/, plus references/mermaid-conventions.md with the conventions every diagram in the project follows. The argument hint lists architecture | lifecycle | flow. The result comes back as a fenced code block, never as prose.
Scope is narrow on purpose: Mermaid only, no image rendering, no other diagram formats. Run the ## Test section from the action file before trusting the output — the skill's own instructions require it.
What it helps with
- turn a service description into a Mermaid diagram
- diagram an order lifecycle from a spec
- show a data flow between modules as one chart
- get diagram source for a README instead of an image
- lock the node list with a plan before anything is drawn
Example prompts for the agent
- Read
docs/architecture.mdand turn it into a Mermaid diagram. Show me the plan first. - Diagram the request lifecycle described below in Mermaid and wait for my OK on the plan.
- Give me Mermaid source for the payment flow, a fenced block is fine.
How to install 09-mermaid
1Plugin marketplace
/plugin marketplace add ai-driven-dev/framework/plugin install aidd-context@aidd-frameworkThis installs the whole aidd-context plugin with all its skills
2Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 09-mermaid -a claude-code3Manually: put the files in place
~/.claude/skills/09-mermaid/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/09-mermaid/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 09-mermaid -a codex2Manually: put the files in place
.agents/skills/09-mermaid/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 09-mermaid -a cursor2Manually: put the files in place
.cursor/skills/09-mermaid/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework plugins/aidd-context/skills/09-mermaid2Manually: put the files in place
.github/skills/09-mermaid/SKILL.md1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 09-mermaid -a gemini-cli2Platform CLI
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-context/skills/09-mermaidManually: put the files in place
.devin/skills/09-mermaid/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 09-mermaid -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about 09-mermaid
How do I install 09-mermaid in Claude Code?
Use the plugin marketplace: /plugin marketplace add ai-driven-dev/framework, then /plugin install aidd-context@aidd-framework. The skill file ends up at ~/.claude/skills/09-mermaid/SKILL.md.
What does 09-mermaid do?
It produces a valid Mermaid diagram from a written source. The order is plan, confirm the plan, generate, review.
Does 09-mermaid render images?
No. You get Mermaid code in a fenced block only; image rendering and other diagram formats are outside what this skill does.
Source text
SKILL.md · MIT
--- name: 09-mermaid description: Generate a valid Mermaid diagram from a written source through a plan, generate, review loop. Use when the user wants to turn an architecture, lifecycle, or flow into a Mermaid diagram. Not for other diagram formats or image rendering. argument-hint: architecture | lifecycle | flow --- # Mermaid Produces a valid, structured Mermaid diagram from a written source by planning it, confirming the plan, generating, and offering a review. ## Actions | # | Action | Role | Input | | --- | --------- | ------------------------------------------------------ | ---------------- | | 01 | `mermaid` | Plan, confirm, generate, and review one diagram | a written source | Run action `01` and run its `## Test` before trusting the result. Before running an action, read its file in `actions/`, not only the table or assets. ## Transversal rules - Plan before generating, and confirm the plan with the user. Block on the answer. - Generate only what the confirmed plan holds. Never add a node or a relationship the user did not confirm. - Follow the project's Mermaid conventions for every diagram. - Output the diagram as a fenced block, never describe it in prose. ## References - `references/mermaid-conventions.md`: the conventions and defaults every generated diagram follows.
© AI-Driven Dev · MIT · ai-driven-dev/framework