REA
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
AI Agent Skill to generate and render beautiful Mermaid diagrams as SVG or terminal ASCII — 15 themes, 6 diagram types, batch CLI, no browser.
作者による原文
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/skills/imxv-pretty-mermaid-skills)同じ作業で AI をサービスにつなぐ MCP
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
MCP server for terminal commands, file operations, and process management
同じ種類の作業。Skill 一覧と同じ並び
| これ Pretty-mermaid-skills | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| 作者 | imxv | morluto | multica-ai | Graphify-Labs | harry0703 |
| Skill 数 | 1 | 1 | 1 | 1 | 1 |
| GitHub スター | 1,589 | 468,733 | 234,332 | 150,287 | 144,566 |
| 最終コード更新 | 2026年8月22日 | 2026年11月19日 | 2026年4月20日 | 2026年11月18日 | 2026年11月18日 |
| ライセンス | MIT | MIT | – | Apache-2.0 | MIT |
imxv による 1 個の Skill(指示セット)。AI が読んでそのとおりに作業します · MCP server ではありません
MCP = 手
AI を外部のサービスやデータにつなぎます(例:Notion を読む、請求書を作る)。プログラムやサーバーが動いている必要があります。
Skill = 手順書
作業のやり方を AI に教えるテキストファイル。どのサービスにもつながりません。
重なる部分もあります。ツールを呼ぶスクリプト付きの Skill や、知識だけを渡す MCP もあります。やりたい作業から選んでください。
Claude CodeCodexCursorGemini CLIOpenCode
提供元の README と repo のフォルダから判断
GitHub アカウント imxv(個人)、作成から 4 年
★ 1,589 スター · コードの最終更新 2026年8月22日
パソコンで実行できるスクリプトが 7 個あります:scripts/batch.mjs, scripts/generate-theme-gallery.mjs, scripts/png.mjs, scripts/render.mjs ほか 3 個のファイル
スクリプト内に通信するコマンドは見つかりませんでした
hook やパソコンの設定への書き込みは見つかりませんでした
リポジトリの commit e234ab7 のファイルから自動でチェックしました(読み取りのみで、何も実行していません)。安全の保証ではありません。ご自身で読んで判断してください
まず:どの AI を使っていますか
使っているアプリを選ぶと、そのアプリでのインストール方法だけが表示されます
説明文が 200 文字を超えているため(491 文字)、claude.ai にはアップロードできません。代わりに「AI にインストールしてもらう」を使ってください
この文をコピーして Claude Code のチャットに貼り付けます
1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます
AI は先に何をするか説明し、各ステップで許可を求めます
Claude Code を開き直し、/Pretty-mermaid-skills と入力するか関連する作業を頼むと Claude が自動で使います
Checked against official docs 2026年11月12日 · Source: code.claude.com
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
git clone --depth 1 https://github.com/imxv/pretty-mermaid-skills.git /tmp/popnx-skill-imxv-pretty-mermaid-skills-e234ab7 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-imxv-pretty-mermaid-skills-e234ab7/.' ~/.claude/skills/pretty-mermaid-skillsChatGPT デスクトップアプリには Codex が組み込まれていて、Codex は ~/.agents/skills フォルダから Skill を読み込みます
ChatGPT デスクトップアプリで Codex を開き、この文をチャットに貼り付けます
インストールの前に、AI が必ずパスを見せます
AI は先に何をするか説明し、各ステップで許可を求めます
pretty-mermaid フォルダを ~/.agents/skills/pretty-mermaid に置きます
~ はホームフォルダ($HOME)です
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
git clone --depth 1 https://github.com/imxv/pretty-mermaid-skills.git /tmp/popnx-skill-imxv-pretty-mermaid-skills-e234ab7 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-imxv-pretty-mermaid-skills-e234ab7/.' ~/.agents/skills/pretty-mermaid-skillsChecked against official docs 2026年11月15日 · Source: learn.chatgpt.com
自分でインストールした Skill は使えません。ディレクトリのプラグインに含まれる Skill だけが使えます
この Skill を ChatGPT で使うには、上の方法で ChatGPT デスクトップアプリを使ってください
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
この文をコピーして Codex のチャットに貼り付けます · ChatGPT デスクトップアプリ内の Codex、Codex CLI、IDE 拡張機能で使えます
1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます
AI は先に何をするか説明し、各ステップで許可を求めます
Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください · 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
git clone --depth 1 https://github.com/imxv/pretty-mermaid-skills.git /tmp/popnx-skill-imxv-pretty-mermaid-skills-e234ab7 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-imxv-pretty-mermaid-skills-e234ab7/.' ~/.agents/skills/pretty-mermaid-skillsこの文をコピーして Cursor のチャットに貼り付けます
1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます
AI は先に何をするか説明し、各ステップで許可を求めます
Cursor の Agent チャットで / を入力し Pretty-mermaid-skills を選ぶ
Checked against official docs 2026年11月12日 · Source: cursor.com
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
git clone --depth 1 https://github.com/imxv/pretty-mermaid-skills.git /tmp/popnx-skill-imxv-pretty-mermaid-skills-e234ab7 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-imxv-pretty-mermaid-skills-e234ab7/.' ~/.cursor/skills/pretty-mermaid-skillsSkill を読めるほかのアプリ向けです。この文には Claude Code、Codex、Cursor のパスが入っていて、AI が使っているアプリに合わせて選びます · この文章をコピーして、アプリのチャットに貼り付けてください
1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます
AI は先に何をするか説明し、各ステップで許可を求めます
Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Gemini CLI や GitHub Copilot など Agent Skills 対応の他のアプリはフォルダが違います。そのアプリのガイドを見て、SKILL.md のあるフォルダをコピーしてください。
2026年11月11日 に Claude Code、Codex、Cursor の公式ガイドで skill フォルダを確認
✓ コマンド確認済み 2026年11月19日
以下は提供元の repo の文章で、PopNx MCP の指示ではありません
7,802 文字 · GitHub で全文を開く
---
name: pretty-mermaid
description: |
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.
---
# Pretty Mermaid
Create or render Mermaid diagrams with the bundled Node.js CLI. Use SVG for scalable documentation, PNG for sharing or raster-only consumers, and ASCII or Unicode for terminals and plain text.
## Working directory
Treat the directory containing this file as `<skill-root>`. Run bundled scripts from that directory, or invoke them with absolute paths. Keep user source and rendered output in the user's requested location; do not copy the renderer into their project.
## Workflow
1. Determine whether the user supplied Mermaid source or needs a diagram authored from prose.
2. Choose the diagram type and output format from the tables below.
3. Read only the relevant reference file when syntax, theme selection, or API behavior needs more detail.
4. Save new source as a `.mmd` file, preserving user terminology and relationships.
5. Render with a named theme or explicit colors.
6. Inspect the result. Fix syntax, clipping, crowded layout, or unclear labels and render again.
7. Return the source and output paths, plus the selected format and theme.
Do not overwrite an existing source or output file unless the user asked for replacement.
## Choose a diagram type
| Need | Diagram type | Starter |
| --- | --- | --- |
| Process, decision tree, architecture | Flowchart | `flowchart LR` |
| API calls, messages, interactions | Sequence | `sequenceDiagram` |
| Lifecycle or finite-state machine | State | `stateDiagram-v2` |
| Classes, modules, relationships | Class | `classDiagram` |
| Database entities and cardinality | ER | `erDiagram` |
| Bars, lines, trends, comparisons | XY chart | `xychart-beta` |
Read `references/DIAGRAM_TYPES.md` when authoring non-trivial Mermaid syntax.
## Choose an output
| Output | Best for | Notes |
| --- | --- | --- |
| SVG | READMEs, docs, slides, websites | Scalable, themed, supports transparency |
| PNG | Chats, previews, raster-only tools | Set `--format png`; no external converter required |
| Unicode | Modern terminals and readable text previews | Default ASCII renderer output |
| Plain ASCII | Logs and restricted terminals | Add `--use-ascii` |
| ANSI-colored text | Interactive terminals | Set `--color-mode` |
## Core commands
Run these from `<skill-root>`.
### List themes
```bash
node scripts/themes.mjs
```
### Render SVG
```bash
node scripts/render.mjs \
--input diagram.mmd \
--output diagram.svg \
--theme tokyo-night
```
### Render terminal text
```bash
node scripts/render.mjs \
--input diagram.mmd \
--output diagram.txt \
--format ascii \
--color-mode none
```
Add `--use-ascii` when Unicode box-drawing characters are not acceptable.
### Render PNG
```bash
node scripts/render.mjs \
--input diagram.mmd \
--output diagram.png \
--format png \
--width 1200 \
--theme tokyo-night
```
### Batch render a directory
```bash
node scripts/batch.mjs \
--input-dir ./diagrams \
--output-dir ./rendered \
--format svg \
--theme github-dark \
--workers 4
```
Use batch rendering for three or more diagrams or when consistent options must be applied to a directory.
## Theme selection
- General dark documentation: `tokyo-night`
- GitHub dark or light surfaces: `github-dark`, `github-light`
- Print and presentations: `zinc-light`
- High-contrast color: `dracula`
- Cool, restrained palette: `nord`, `nord-light`
Read `references/THEMES.md` or open `docs/THEME_GALLERY.md` when visual theme choice matters. A named theme can be refined with explicit color flags.
## Useful options
### Shared styling
| Option | Purpose |
| --- | --- |
| `--theme <name>` | Apply one of the 15 built-in themes |
| `--bg`, `--fg` | Set required base colors |
| `--line`, `--accent`, `--muted` | Refine connectors, highlights, and secondary text |
| `--surface`, `--border` | Refine node fill and stroke |
| `--font <name>` | Set the SVG font family |
### SVG
| Option | Purpose |
| --- | --- |
| `--transparent` | Remove the SVG background |
| `--padding <n>` | Set canvas padding |
| `--node-spacing <n>` | Set horizontal node spacing |
| `--layer-spacing <n>` | Set vertical layer spacing |
| `--component-spacing <n>` | Separate disconnected components |
| `--interactive` | Enable XY chart hover tooltips |
### PNG
| Option | Purpose |
| --- | --- |
| `--width <n>` | Set output width from 100 to 10000 pixels while preserving aspect ratio |
| `--transparent` | Preserve a transparent background |
### Terminal output
| Option | Purpose |
| --- | --- |
| `--use-ascii` | Replace Unicode box drawing with plain ASCII |
| `--padding-x`, `--padding-y` | Tune diagram spacing |
| `--box-border-padding` | Tune padding inside node boxes |
| `--color-mode <mode>` | `none`, `auto`, `ansi16`, `ansi256`, `truecolor`, or `html` |
Run `node scripts/render.mjs --help` or `node scripts/batch.mjs --help` for the authoritative CLI list.
## Authoring guidance
- Prefer short, concrete labels; preserve domain-specific terms from the user.
- Use explicit edge labels when a branch or message is ambiguous.
- Keep large diagrams readable by splitting unrelated concerns instead of shrinking text.
- Use `LR` for wide flows and `TB` for narrow documents.
- Avoid communicating meaning through color alone.
- Use a light theme for print and confirm contrast against the final background.
- For unfamiliar syntax, start from `assets/example_diagrams/` and consult the diagram reference.
## Validation
After rendering:
1. Confirm the command exits successfully and the output file is non-empty.
2. Confirm SVG output begins with `<svg`; confirm PNG output opens as a valid image; confirm text output contains visible diagram content.
3. Inspect visual output when layout matters, especially long labels, CJK text, disconnected components, and XY charts.
4. Confirm arrows, cardinalities, states, and labels match the source request.
5. Report any renderer limitation instead of silently dropping unsupported syntax.
Run both `npm test` and `npm run validate` when changing this skill, its scripts, templates, or references.
## Troubleshooting
- Missing dependency: run `npm install` in `<skill-root>`; the CLI also attempts a first-run install.
- Unknown theme: run `node scripts/themes.mjs` and use an exact listed name.
- Parse error: consult `references/DIAGRAM_TYPES.md`, reduce to the failing statement, then restore the diagram incrementally.
- Crowded SVG: increase `--node-spacing`, `--layer-spacing`, or `--component-spacing`.
- PNG color error: use concrete hex values for custom colors; unresolved external CSS variables cannot be rasterized.
- Terminal color escape codes in redirected output: use `--color-mode none`.
## Reference routing
| Resource | Read or use when |
| --- | --- |
| `references/DIAGRAM_TYPES.md` | Authoring or debugging Mermaid syntax |
| `references/THEMES.md` | Comparing themes or defining custom colors |
| `references/api_reference.md` | Extending scripts or calling `beautiful-mermaid` directly |
| `docs/THEME_GALLERY.md` | Choosing a theme visually |
| `assets/example_diagrams/` | Starting from a supported diagram template |
| `scripts/render.mjs` | Rendering one diagram |
| `scripts/batch.mjs` | Rendering a directory in parallel |
| `scripts/themes.mjs` | Listing installed themes |
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。