Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-context@aidd-framework
Open on GitHub

What 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.md and 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-framework

This 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-code

3Manually: put the files in place

~/.claude/skills/09-mermaid/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/09-mermaid/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set80

The whole set →
1-conventions The 1-conventions rule sets conventions for TypeScript files under src/ and tests/, covering module structure, file names, and test tiers. Use it when adding code or tests to a project. CX Codex +1 ★ 571repo stars 05-rule-generate 05-rule-generate takes a coding rule from draft to the rule files of installed AI hosts: create, edit, publish, delete. CX Codex +1 ★ 571repo stars 07-command-generate 07-command-generate generates flat slash commands across the AI assistants enabled in your repository. Useful when you need to scaffold or edit single-step commands without manual path wiring. CX Codex +1 ★ 571repo stars 0-hexagonal The 0-hexagonal rule splits each context into four layers and keeps dependencies pointed inward. Use it when reviewing TypeScript architecture. CX Codex +1 ★ 571repo stars 06-test 06-test finds untested behaviors, iterates tests until they pass, and validates user flows end to end in the browser. CX Codex +1 ★ 571repo stars 03-release-tag 03-release-tag is a Claude Code skill that prepares SemVer releases from recent commits, updates version files, and creates annotated tags after you review the release details. CX Codex +1 ★ 571repo stars 08-hook-generate 08-hook-generate builds one hook: a handler fired at a lifecycle event of the host tool, with a config entry per tool and the script behind it. CX Codex +1 ★ 571repo stars 06-product-brief 06-product-brief drafts a concise product brief before gathering requirements. Helps outline an opportunity and establish how to validate it. CX Codex +1 ★ 571repo stars

Project sponsors

Companies that keep this analytics open