ahgraber/mermaid
skills/mermaid/SKILL.md
Generate Mermaid diagrams for chatbot flows that render in Markdown, including choosing diagram types, producing valid Mermaid code blocks, and validating or rendering diagrams locally via the bundled scripts. Use when a user asks for chatbot flowcharts/sequence/state diagrams, wants Mermaid syntax, or needs to verify/render Mermaid without a web service.
$ install --global
skillsauthnpx skillsauth add ahgraber/skills 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 10, 2026, 3:10 AM8.4s4 files scanned
SKILL.md
- name:
- mermaid
- description:
- |-
Mermaid Diagrams for Chatbots
Use this skill to create Mermaid diagrams that render well in Markdown chat interfaces, validate their syntax locally, and render images without calling a web service.
Invocation Notice
- Inform the user when this skill is being invoked by name:
mermaid.
Workflow
- Identify the diagram type (flowchart, sequenceDiagram, stateDiagram-v2) based on the request.
- Draft Mermaid code in a fenced Markdown block using
mermaid. - Follow formatting conventions in
references/chatbot-mermaid-guidelines.md. - Validate the diagram using
scripts/validate_mermaid.py. - If the user wants an image file, render with
scripts/render_mermaid.py.
Scripts
scripts/validate_mermaid.py- Validate Mermaid code by invoking the local Mermaid CLI (
mmdc). - Use when you need to check whether Mermaid parses without errors.
- Validate Mermaid code by invoking the local Mermaid CLI (
scripts/render_mermaid.py- Render Mermaid to SVG/PNG/PDF using the local Mermaid CLI (
mmdc). - Prefer SVG for Markdown renderers when image embedding is required.
- Render Mermaid to SVG/PNG/PDF using the local Mermaid CLI (
Notes
- These scripts expect
mmdcto be available on PATH (Mermaid CLI). If missing, instruct the user to install it locally; do not use the Mermaid web service. - Dependencies are managed via inline
uvscript metadata in each Python script. Use--install-chromiumto bootstrap the Chromium binary via pyppeteer when needed. - Keep diagrams compact and readable in chat: avoid overly wide graphs, use short labels, and group related states.
- If the user asks for raw Markdown, return only the fenced
mermaidblock unless they ask for extra explanation.
Related Skills
ahgraber/python-testing
development
VerifiedTrustedCommunity
Use when writing or reviewing tests for Python behavior, contracts, async lifecycles, or reliability paths. Also use when tests are flaky, coupled to implementation details, missing regression coverage, slow to run, or when unclear what tests a change needs. Use for multi-Python version testing (nox) and free-threaded Python thread-safety validation.
3SKILL.mdUpdated Mar 29, 2026
ahgraber/editorial-review
development
VerifiedTrustedCommunity
Use when the user wants rigorous, non-sycophantic editorial feedback on a draft, essay, blog post, or argument through back-and-forth dialogue — pressure-testing thesis, structure, argument, clarity, tone, and evidence. Triggers: "be my sparring partner", "pressure-test this draft", "poke holes in my argument", "is this ready to publish", "sharpen this post", "where is this weak". Not for one-shot copyediting, proofreading, or ghostwriting.
2SKILL.mdUpdated May 26, 2026
ahgraber/synthesize
testing
VerifiedTrustedCommunity
Use when distilling the through-line gist of one or more sources — the spine, argument, tension, or recurring frame running through a set of documents, notes, research, or transcripts, OR across the ideas within a single rich piece — into a few concise paragraphs. Triggers: "synthesize", "what's the through-line/gist", "extract the insight", "pull these together". Not for faithful summary or condensation that covers what a source says, nor for comparisons or catalogs where enumeration is the deliverable.
2SKILL.mdUpdated May 22, 2026
ahgraber/writing-tests
development
VerifiedTrustedCommunity
Use when writing or reviewing tests in any language, or diagnosing a suite that is slow, brittle, or hard to read. Triggers: "write tests", "how should I test this", "what kind of test", "test is flaky/fragile", "should I mock this", "test is hard to read". For Python-specific guidance see `python-testing`.
2SKILL.mdUpdated May 16, 2026