# Pretty Mermaid (agent 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.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/imxv/Pretty-mermaid-skills |
| Skill path | SKILL.md |
| Skill name | pretty-mermaid |
| GitHub stars | 1,518 |
| Installs on skills.sh | not listed |
| License | MIT |
| Skills in repo | 1 |
| Plugin marketplace | no |
| Official | no |
| Works with | Claude Code, Codex, Cursor, Gemini CLI, OpenCode |
| Category | Data & analysis |
| Last commit | Aug 22, 2026 |

## Add this skill

### Claude Code

```sh
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 project
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
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 projects
```

### Cursor

```sh
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 projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

---

Canonical page: https://appsgit.com/skills/imxv-pretty-mermaid
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.