Spoon94/skill-vault / diagram/diagram-mermaid
diagram-mermaid
VerifiedGenerate Mermaid code blocks (` ```mermaid ` fences) for inline Markdown rendering of technical diagrams. Covers 11 types — flowchart, sequence, class, state, ER, Gantt, pie, mindmap, timeline, gitGraph, and journey. Use whenever the user asks for a flowchart, sequence diagram, state diagram, ER diagram, Gantt chart, pie chart, mindmap, timeline, git graph, or user journey map. Trigger on: "画流程图" "画时序图" "状态图" "ER图" "甘特图" "饼图" "思维导图" "时间线" "git图" "用户旅程" "Mermaid" "GitHub 渲染" "嵌入文档" or any diagram request where the output should be inline Markdown. Part of the diagram skill family — pick this skill for Mermaid code blocks, zero-dependency output that renders natively in GitHub/Markdown, or one of the 11 supported types. Lightest-weight entry point of the diagram family — default for "画个流程图/时序图" unless another format is explicitly requested.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.9 KB |
| examples/class.md | markdown | 1.6 KB |
| examples/er.md | markdown | 1.3 KB |
| examples/flowchart.md | markdown | 904 B |
| examples/gantt.md | markdown | 1.6 KB |
| examples/gitgraph.md | markdown | 1.3 KB |
| examples/journey.md | markdown | 1.3 KB |
| examples/mindmap.md | markdown | 1.1 KB |
| examples/pie.md | markdown | 776 B |
| examples/sequence.md | markdown | 1.2 KB |
| examples/state.md | markdown | 1.3 KB |
| examples/timeline.md | markdown | 1.1 KB |
| references/common-pitfalls.md | markdown | 8.1 KB |
| references/layout-best-practices.md | markdown | 5.6 KB |
| references/mermaid-syntax.md | markdown | 9.9 KB |
examples/state.md
View on GitHub# State Diagram Example
A state machine for an order lifecycle, including retry and terminal states.
```mermaid
stateDiagram-v2
[*] --> Pending
Pending --> Paid : payment received
Pending --> Cancelled : user cancels
Paid --> Processing : merchant accepts
Processing --> Shipped : items packed
Processing --> Failed : out of stock
Failed --> Pending : restock
Shipped --> Delivered : carrier delivers
Delivered --> Returned : user returns
Returned --> [*]
Delivered --> [*]
Cancelled --> [*]
state Processing {
[*] --> ReserveStock
ReserveStock --> PackItems : reserved
PackItems --> AssignCarrier : packed
AssignCarrier --> [*] : ready
}
note left of Failed : auto-retry 3x then notify
note right of Shipped : tracking email sent
```
## Key syntax
- `stateDiagram-v2` — modern syntax (use this, not `stateDiagram`)
- `[*]` — initial/final pseudo-state
- `A --> B : event` — labeled transition
- `state Name {\n ...\n}` — composite state
- `note left of X : text` — note attached to state
## Common variations
- `A --> B : event [condition]` — guarded transition
- `A --> B : event / action()` — transition with action
- `state Fork <<fork>>` — fork pseudo-state
- `state Join <<join>>` — join pseudo-state
- `note left of A : text\nmulti-line`
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |