mermaid-skill
A Claude Code skill that generates Mermaid (.mmd) diagrams from user requests, validates Mermaid syntax before export, and exports to PNG/SVG/PDF using either local mermaid-cli (mmdc) or a fallback Kroki API endpoint.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
Likely communicates over HTTPS when using web services, but TLS enforcement is not explicitly stated. No auth model or scope control is described for the skill. Dependency hygiene cannot be assessed from the provided content (no dependency list/CVE info). Secret handling practices are not documented; however, the workflow implies local file generation and optional external rendering.
⚡ Reliability
Best When
You want end-to-end Mermaid diagram generation with automatic layout and multiple export formats, especially when you benefit from pre-export validation and a Kroki fallback.
Avoid When
You require strong, explicit API-level security controls, or you must avoid any external network calls (even optional fallbacks).
Use Cases
- • Generate architecture, sequence, flow, and state diagrams from textual descriptions
- • Create database ER diagrams and class/OOP diagrams from domain modeling notes
- • Produce documentation-ready diagram exports (PNG for visuals, SVG/PDF for docs)
- • Automate a generate→validate→export workflow to reduce broken diagrams
Not For
- • High-assurance or compliance-critical diagram generation without validation guarantees from the toolchain
- • Environments that cannot reach external services (Kroki) when mmdc is unavailable
- • Use as a general-purpose diagramming API/SDK for arbitrary programmatic diagram rendering
Interface
Authentication
No authentication described for the skill itself. If Kroki is used, any required credentials (if applicable) are not specified in the provided README; usage examples only show curl without auth.
Pricing
README does not discuss pricing tiers for the skill or for any third-party dependency (e.g., Kroki).
Agent Metadata
Known Gotchas
- ⚠ If mmdc is unavailable, the skill falls back to Kroki API; external network access and availability may affect outcomes.
- ⚠ Mermaid syntax validation is mentioned, but exact validation behavior and limits (e.g., size/timeout) are not specified.
- ⚠ The skill behavior may differ for Chinese-trigger phrases vs explicit diagram requests; prompting should be explicit when needed.
Alternatives
Full Evaluation Report
Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for mermaid-skill.
AI-powered analysis · PDF + markdown · Delivered within 30 minutes
Package Brief
Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.
Delivered within 10 minutes
Score Monitoring
Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.
Continuous monitoring
Scores are editorial opinions as of 2026-03-30.