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,518 GitHub stars.
- Data & analysis
- Actively maintained
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
Migration
JuliusBrussee/caveman
Implement reversible compatibility-safe transitions.
Data & analysisGoDating Web
nexu-io/open-design
A consumer-feeling dating / matchmaking dashboard — left rail navigation, ticker bar of community signals, headline KPIs, a 30-day mutual-matches bar chart, and a match-rate trend block.
Data & analysisTypeScriptDcf Valuation
nexu-io/open-design
Discounted cash flow valuation and intrinsic value analysis for public companies.
Data & analysisTypeScriptFlowai Live Dashboard Template
nexu-io/open-design
Team-management dashboard skill in the FlowAI aesthetic — three tabs (Team Members, Team Details, Activity Log), KPI stat row, member table, role distribution bar chart, online presence and activity…
Data & analysisTypeScriptHow It Works
thedotmack/claude-mem
Explain how claude-mem captures observations, when memory injection kicks in, and where data lives.
Data & analysisTypeScriptWeekly Digests
thedotmack/claude-mem
Generate a serial week-by-week narrative digest of a project's full claude-mem timeline.
Data & analysisTypeScript
What is the Pretty Mermaid skill?
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,518 GitHub stars. Its SKILL.md lives at github.com/imxv/Pretty-mermaid-skills.
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.