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,543 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 Oct 26, 2026
Data & analysisRustReport
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 & analysisPythonDbt 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 & analysisTypeScriptWebperf Interaction
nucliweb/webperf-snippets
Intelligent interaction performance analysis with automated workflows for INP debugging, scroll jank investigation, and main thread blocking.
Active · last commit Oct 26, 2026
Data & analysisJavaScriptPortaljs Define Schema
datopian/portaljs
Define a dataset's metadata profile — infer a Frictionless Table Schema from its data, add Data Package metadata (license, sources, keywords), and write it into datasets.json so the showcase renders…
Active · last commit Oct 21, 2026
OfficialData & analysisTypeScriptAmj Contribution Framing
brycewang-stanford/Awesome-Journal-Skills
Use when turning results into an explicit theoretical contribution for an Academy of Management Journal (AMJ) manuscript — the "what new theory do we learn?" statement and the discussion section.
Active · last commit Sep 27, 2026
Data & analysisStata
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.