Pretty Mermaid
Pretty Mermaid is an agent skill (a SKILL.md file) from imxv/Pretty-mermaid-skills. Generate and render Mermaid diagrams for architecture docs, READMEs, PRs, terminals, chats, and CI as themed SVG, PNG, or ASCII/Unicode art. It works with Claude Code, Codex, Cursor, Gemini CLI and OpenCode and has 1,584 GitHub stars.
github.com/imxv/Pretty-mermaid-skills (opens in a new tab)
Data as of from the GitHub API; description from the skill's SKILL.md. Report an error
Add this skill
Claude
Claude Code loads skills from ~/.claude/skills/ (all projects) or .claude/skills/ (one project):
git clone --depth 1 https://github.com/imxv/Pretty-mermaid-skills.git
cp -r Pretty-mermaid-skills ~/.claude/skills/pretty-mermaid # personal, or .claude/skills in a projectIn the Claude apps, zip the pretty-mermaid folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).
ChatGPT / Codex
Codex reads skills from .agents/skills/ in a repo or ~/.agents/skills/ for every project:
git clone --depth 1 https://github.com/imxv/Pretty-mermaid-skills.git
cp -r Pretty-mermaid-skills .agents/skills/pretty-mermaid # repo; ~/.agents/skills for all projectsStandalone skills also load in the ChatGPT desktop app.
Cursor
Cursor loads skills from .cursor/skills/ (or ~/.cursor/skills/) and also reads .claude/skills/:
git clone --depth 1 https://github.com/imxv/Pretty-mermaid-skills.git
cp -r Pretty-mermaid-skills .cursor/skills/pretty-mermaid # project; ~/.cursor/skills for all projectsSource (checked Oct 7, 2026): code.claude.com/docs/en/skills (opens in a new tab), support.claude.com/en/articles/12512180-using-skills-in-claude (opens in a new tab), learn.chatgpt.com/docs/build-skills (opens in a new tab), cursor.com/docs/context/skills (opens in a new tab)
What this skill does
Generate and render Mermaid diagrams for architecture docs, READMEs, PRs, terminals, chats, and CI as themed SVG, PNG, or ASCII/Unicode art. Use this skill whenever the user provides Mermaid code or .mmd files; asks for a flowchart, sequence/state/class diagram, ERD, XY chart, or architecture/workflow/data-model visualization; or wants to beautify, theme, batch-convert, or make a diagram terminal-friendly. Runs locally without a browser or DOM, with 15 built-in themes and custom colors.
Similar skills
More data & analysis skills
Minutes Ingest
silverstein/minutes
Extract facts from meetings and update your knowledge base — person profiles, chronological log, and index.
Active · last commit Nov 13, 2026
Data & analysisRustSecond Brain Metrics
undefined-ui/second-brain-os
Record a dated snapshot of the vault's health numbers and compare against previous snapshots so trends are visible.
Too new to judge · created Sep 7, 2026
Data & analysisHTMLDbt Ingest
Kaelio/ktx
Map dbt schema.yml / properties.yml models and sources into ktx semantic-layer overlays and column notes.
Maintained · last commit Jul 7, 2026
Data & analysisTypeScriptReport
evo-hq/evo
Read-only evo run reporting. Use when the user invokes /evo:report, asks what happened overnight, asks what improved recently, asks for the best/frontier candidates, asks for a quick score chart…
Active · last commit Oct 5, 2026
Data & analysisPythonComps Analysis
ginlix-ai/LangAlpha
Comparable company analysis: peer set, operating metrics, valuation multiples, statistics and an implied value.
Active · last commit Nov 16, 2026
Data & analysisPythonOma Mobile
first-fluke/oh-my-agent
Implement Flutter, React Native, native Swift, or native Kotlin Android apps.
Active · last commit Nov 16, 2026
Data & analysisTypeScript
How do I install the Pretty Mermaid skill?
Copy the pretty-mermaid folder (the one containing SKILL.md) into ~/.claude/skills/ for Claude Code, .agents/skills/ for Codex or .cursor/skills/ for Cursor. The agent picks it up automatically when a task matches its description.
Is the Pretty Mermaid skill free?
Yes. The repository is open source under the MIT license.
Is Pretty Mermaid maintained?
The repository's most recent commit was on Aug 22, 2026. appsgit only lists skills from repositories with a commit in the last six months.