armandli/mermaid-diagram-guide
skills/mermaid-diagram-guide/SKILL.md
Reference guide for Mermaid diagram syntax covering all major diagram types used in software engineering. Use when creating or writing mermaid diagrams, asking "how do I write a mermaid X diagram", "what is the syntax for mermaid", "create a sequence/flowchart/class/ER/gantt/state/C4/architecture diagram in mermaid", or "help me with mermaid". Do NOT use for rendering diagrams or non-mermaid diagram tools.
tools
Updated May 30, 2026
$ install --global
skillsauthnpx skillsauth add armandli/get-skilled mermaid-diagram-guideInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 31, 2026, 2:32 AM123.6s1 file scanned
SKILL.md
- name:
- mermaid-diagram-guide
- description:
- Reference guide for Mermaid diagram syntax covering all major diagram types used in software engineering. Use when creating or writing mermaid diagrams, asking "how do I write a mermaid X diagram", "what is the syntax for mermaid", "create a sequence/flowchart/class/ER/gantt/state/C4/architecture diagram in mermaid", or "help me with mermaid". Do NOT use for rendering diagrams or non-mermaid diagram tools.
- argument-hint:
- [diagram-type]
Validation
To validate a diagram, write its content (without markdown fences) to a .mmd file. A PostToolUse
hook will automatically run mmdc -i <file> -o <tmp>.svg and feed any syntax errors back so you can
fix them. If mmdc is not installed, validation is skipped; the user can install it with:
npm install -g @mermaid-js/mermaid-cli
Overview
Mermaid diagrams are declared with a diagram type keyword followed by content. All diagrams can be embedded in markdown with triple-backtick fences:
```mermaid
<diagram-type>
<content>
```
Diagram Types Quick Reference
| Diagram | Keyword | Best For |
|---------|---------|----------|
| Flowchart | flowchart | Processes, workflows, decision trees |
| Sequence | sequenceDiagram | Inter-service/actor message flows |
| Class | classDiagram | OOP structure, data models |
| ER | erDiagram | Database schemas |
| State | stateDiagram-v2 | State machines, lifecycle |
| Gantt | gantt | Project timelines |
| Requirement | requirementDiagram | System requirements (SysML) |
| C4 | C4Context / C4Container / C4Component | Software architecture |
| ZenUML | zenuml | Alternative sequence syntax |
| Mindmap | mindmap | Brainstorming, hierarchical ideas |
| Architecture | architecture-beta | Infrastructure, system components |
| Kanban | kanban | Task boards |
| Block | block-beta | Component layout |
| Packet | packet-beta | Network packet structure |
| Treemap | treemap-beta | Hierarchical data proportions |
| TreeView | treeView-beta | Directory/file trees |
References
For complete syntax details on each diagram type, see:
- Flowchart
- Sequence Diagram
- Class Diagram
- Entity Relationship Diagram
- Gantt
- State Diagram
- Requirement Diagram
- C4 Diagram
- ZenUML
- Mindmap
- Architecture
- Kanban
- Block Diagram
- Packet
- Treemap
- TreeView
Related Skills
armandli/skills/update-readme
tools
VerifiedTrustedCommunity
--- name: update-readme description: Updates a project README.md with build instructions, unit test instructions, and a mermaid architecture diagram. Use when a project README needs to be created or refreshed. Trigger phrases: "update readme", "generate readme", "create readme", "refresh readme docs". Emphasizes project interfaces, extension points, and customization hooks in the diagram — not concrete implementations. Do NOT use for documentation sites, wikis, or non-project READMEs. argument-h
SKILL.mdUpdated May 30, 2026
armandli/skills/skill-stat
business
VerifiedTrustedCommunity
--- name: skill-stat description: Records skill usage statistics and issue reports into .claude/skill-stats.md. Increments the Uses count for a skill name, and optionally logs an issue report that increments the Issues count and appends a row to the Issue Reports table. Use when tracking how often a skill is invoked, when a user reports a problem with a skill, or when another skill needs to log its own usage. Trigger phrases: "record skill stat", "log skill usage", "report skill issue". Do NOT u
SKILL.mdUpdated May 30, 2026
armandli/skills/revert
testing
VerifiedTrustedCommunity
--- name: revert description: Reverts ALL git changes in the working directory: staged changes, unstaged modifications, and new untracked files. Use when user asks to "revert all changes", "undo all changes", "discard all changes", "reset all git changes", or "clean working directory". Do NOT use for reverting a specific file or a specific commit — those need targeted git commands. disable-model-invocation: true --- Revert all git changes in the working directory. This is destructive and cannot
SKILL.mdUpdated May 30, 2026
armandli/refactor-python
tools
VerifiedTrustedCommunity
Scans a Python codebase for duplicate or near-duplicate logic patterns across functions, classes, and files, then extracts those patterns into typed utility classes in a shared module. Use when the user asks to "refactor this Python code", "find duplicate logic", "extract shared utilities", "apply DRY to Python", "deduplicate Python code", or "find repeated patterns in Python". Groups extracted helpers by the object type they operate on (strings, numbers, dates, collections, etc.). Do NOT use for performance optimization (use optimize-python), for debugging logic errors, or for explaining code. Do NOT extract code that appears only once. Run this skill before optimize-python.
SKILL.mdUpdated May 30, 2026