haowjy/mermaid
.agents/skills/mermaid/SKILL.md
Rules and validation for Mermaid diagrams. Use when creating or editing Mermaid diagrams in documentation.
documentation
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add haowjy/pokemon-amber mermaidInstall 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: Apr 24, 2026, 8:54 PM1.8s1 file scanned
SKILL.md
- name:
- mermaid
- description:
- Rules and validation for Mermaid diagrams. Use when creating or editing Mermaid diagrams in documentation.
Mermaid Diagram Rules
After writing or editing any Mermaid block, validate with the co-located script: scripts/check-mermaid.sh <file>.
1. Quote labels and edges that contain special characters
Any node label with (), [], <>, <br/>, ,, or emoji must be wrapped in ["..."]. Same idea for edge labels — use |"..."|.
| Context | Needs quotes? | Example |
|---------|--------------|---------|
| Simple text only | No | A[Hello World] |
| Contains () | Yes | A["Config (optional)"] |
| Contains [] | Yes | A["items list"] (avoid [] entirely) |
| Contains <br/> | Yes | A["Line 1<br/>Line 2"] |
| Contains emoji | Yes | A["Done ✓"] |
| Contains " | Escape | A["Say 'hello'"] |
| Edge with specials | Yes | A -->\|"data (raw)"\| B |
flowchart LR
A["Turn 1: user"] -->|"StreamEvents (Delta, Block)"| B["blocks list"]
C["UI Panels (Thread, Tool)"]
2. Use <br/> for line breaks
Not \n. In flowchart labels, quote the label when using <br/>.
flowchart LR
A["Turn 1<br/>user message"] --> B["Next step"]
sequenceDiagram
Note over A,B: First line<br/>Second line
3. The end keyword
Lowercase end as a node label breaks flowcharts and sequence diagrams. Capitalize it or wrap in quotes:
flowchart LR
A["end of process"] --> B["End"]
4. Prefer Mermaid themes for general styling
Use built-in themes (default, dark, neutral, forest, base) rather than styling every node. classDef and style are fine for intentional emphasis (error paths, highlights), but avoid overriding the theme's defaults — hardcoded fills break in dark mode.
For rect grouping in sequence diagrams, use near-transparent fills:
rect rgba(128, 128, 128, 0.08)
Note over A,B: Phase label
end
Edge Cases
oandxafter links:A---oBcreates a circle-end edge,A---xBa cross-end. Add a space if your node ID starts withoorx:A--- oNode.- Semicolons in sequence diagrams: Interpreted as markup. Use
#59;for literal semicolons.
Validation
The validation script lives at scripts/check-mermaid.sh within this skill directory. It extracts each ```mermaid block, validates it with mmdc, and reports file + line number for failures.
# Validate specific file
scripts/check-mermaid.sh path/to/file.md
# Validate all .md files recursively from cwd
scripts/check-mermaid.sh
# Validate a directory
scripts/check-mermaid.sh docs/features/
Related Skills
haowjy/writing-staffing
data-ai
VerifiedTrustedCommunity
Team composition for writing workflows — which agents to spawn, how many, what focus areas to assign, and how to scale effort. Use when composing critic panels, dispatching researchers, staffing draft/revise loops, or setting up brainstorm fan-outs.
SKILL.mdUpdated Apr 16, 2026
haowjy/writing-principles
testing
VerifiedTrustedCommunity
What fiction readers actually want, framed as four composable reward channels (transportation, aesthetic, social simulation, flow), and the specific documented ways alignment training damages each one. Grounded in reader-psychology research and empirical NLP findings. Load when drafting prose, critiquing a draft, deciding whether to show or tell, diagnosing why a passage feels flat, or reasoning about why a scene is or isn't working.
SKILL.mdUpdated Apr 16, 2026
haowjy/writing-issues
testing
VerifiedTrustedCommunity
Logging and referencing writing issues — craft problems, tics, inconsistencies, and structural concerns found during analysis, critique, or review. Use when an agent identifies something worth tracking beyond a single critique report: repeated tics across chapters, inconsistencies that affect multiple scenes, structural problems that need the author's attention, or patterns that should be fixed in revision.
SKILL.mdUpdated Apr 16, 2026
haowjy/writing-artifacts
development
VerifiedTrustedCommunity
Shared artifact convention between orchestrators — what goes where in `$MERIDIAN_FS_DIR/` and `$MERIDIAN_WORK_DIR/`, how artifacts flow between phases, and what each directory means. Use whenever work artifacts, style files, knowledge entries, drafts, or critique reports are being created, referenced, or discussed.
SKILL.mdUpdated Apr 16, 2026