プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

Pretty-mermaid-skills Skill

リポジトリ ↗

作者:imxv★ 1,5891 個の skill

インストール

できること

AI Agent Skill to generate and render beautiful Mermaid diagrams as SVG or terminal ASCII — 15 themes, 6 diagram types, batch CLI, no browser.

作者による原文

  • 接続方法 AI が読む指示ファイル
  • アカウントまたはキー README と SKILL.md にキーは見つかりませんでした
  • カテゴリ コーディング
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/imxv-pretty-mermaid-skills.svg)](https://mcp.popnx.com/en/skills/imxv-pretty-mermaid-skills)

一緒に使える

同じ作業で AI をサービスにつなぐ MCP

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

作者:morluto広く使われている↓ 38.9万/週★ 46.9万8 日前更新

MCP · サービスにつなぐパソコンで動く

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

作者:fallow-rs広く使われている↓ 244.1万/週★ 5385昨日更新

MCP · サービスにつなぐパソコンで動く

似た Skill

同じ種類の作業。Skill 一覧と同じ並び

似たものと比べる
これ
Pretty-mermaid-skills
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
作者imxvmorlutomultica-aiGraphify-Labsharry0703
Skill 数11111
GitHub スター1,589468,733234,332150,287144,566
最終コード更新2026年8月22日2026年11月19日2026年4月20日2026年11月18日2026年11月18日
ライセンスMITMIT–Apache-2.0MIT

imxv による 1 個の Skill(指示セット)。AI が読んでそのとおりに作業します · MCP server ではありません

Skill と MCP の違い

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 を使っていますか

使っているアプリを選ぶと、そのアプリでのインストール方法だけが表示されます

方法 1claude.ai にアップロード(Web とアプリ)

説明文が 200 文字を超えているため(491 文字)、claude.ai にはアップロードできません。代わりに「AI にインストールしてもらう」を使ってください

方法 1Claude Code にインストールしてもらう

この文をコピーして Claude Code のチャットに貼り付けます

インストール先
Please install the skill pretty-mermaid from https://github.com/imxv/pretty-mermaid-skills(commit e234ab7) for all my projects, at ~/.claude/skills/pretty-mermaid. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill pretty-mermaid from https://github.com/imxv/pretty-mermaid-skills(commit e234ab7) into the project this chat is open in (at .claude/skills/pretty-mermaid). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます

AI は先に何をするか説明し、各ステップで許可を求めます

Claude Code を開き直し、/Pretty-mermaid-skills と入力するか関連する作業を頼むと Claude が自動で使います

Checked against official docs 2026年11月12日 · Source: code.claude.com

Terminal を使う方へ

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.claude/skills にコピー

    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-skills
  3. Claude Code を開き直し、/Pretty-mermaid-skills と入力するか関連する作業を頼むと Claude が自動で使います

自分でインストールした Skill は ChatGPT デスクトップアプリ、Codex CLI、IDE の Codex 拡張機能で使えます · Web 版とモバイル版の ChatGPT では自分でインストールした Skill は使えず、ディレクトリのプラグインに含まれる Skill だけが使えます

ChatGPT デスクトップアプリ

ChatGPT デスクトップアプリには Codex が組み込まれていて、Codex は ~/.agents/skills フォルダから Skill を読み込みます

方法 1ChatGPT にインストールしてもらう

ChatGPT デスクトップアプリで Codex を開き、この文をチャットに貼り付けます

インストール先
Please install the skill pretty-mermaid from https://github.com/imxv/pretty-mermaid-skills(commit e234ab7) for all my projects, at ~/.agents/skills/pretty-mermaid. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill pretty-mermaid from https://github.com/imxv/pretty-mermaid-skills(commit e234ab7) into the project this chat is open in (at .agents/skills/pretty-mermaid). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

インストールの前に、AI が必ずパスを見せます

AI は先に何をするか説明し、各ステップで許可を求めます

方法 2自分でフォルダを置く

pretty-mermaid フォルダを ~/.agents/skills/pretty-mermaid に置きます

~ はホームフォルダ($HOME)です

Terminal を使う方へ

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.agents/skills にコピー

    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

インストールしたあと

  • ChatGPT デスクトップアプリ:サイドバーの Skills を開いて Skill があるか確認します
  • 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します
  • Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

Web 版とモバイル版の ChatGPT

自分でインストールした Skill は使えません。ディレクトリのプラグインに含まれる Skill だけが使えます

この Skill を ChatGPT で使うには、上の方法で ChatGPT デスクトップアプリを使ってください

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

方法 1Codex にインストールしてもらう

この文をコピーして Codex のチャットに貼り付けます · ChatGPT デスクトップアプリ内の Codex、Codex CLI、IDE 拡張機能で使えます

インストール先
Please install the skill pretty-mermaid from https://github.com/imxv/pretty-mermaid-skills(commit e234ab7) for all my projects, at ~/.agents/skills/pretty-mermaid. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill pretty-mermaid from https://github.com/imxv/pretty-mermaid-skills(commit e234ab7) into the project this chat is open in (at .agents/skills/pretty-mermaid). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます

AI は先に何をするか説明し、各ステップで許可を求めます

Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください · 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

Terminal を使う方へ

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.agents/skills にコピー

    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
  3. Codex を開き直して関連する作業を頼むと、Codex が skill を一覧に出します

方法 1Cursor にインストールしてもらう

この文をコピーして Cursor のチャットに貼り付けます

インストール先
Please install the skill pretty-mermaid from https://github.com/imxv/pretty-mermaid-skills(commit e234ab7) for all my projects, at ~/.cursor/skills/pretty-mermaid. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill pretty-mermaid from https://github.com/imxv/pretty-mermaid-skills(commit e234ab7) into the project this chat is open in (at .cursor/skills/pretty-mermaid). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます

AI は先に何をするか説明し、各ステップで許可を求めます

Cursor の Agent チャットで / を入力し Pretty-mermaid-skills を選ぶ

Checked against official docs 2026年11月12日 · Source: cursor.com

Terminal を使う方へ

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.cursor/skills にコピー

    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-skills
  3. Cursor の Agent チャットで / を入力し Pretty-mermaid-skills を選ぶ

方法 1AI にインストールしてもらう

Skill を読めるほかのアプリ向けです。この文には Claude Code、Codex、Cursor のパスが入っていて、AI が使っているアプリに合わせて選びます · この文章をコピーして、アプリのチャットに貼り付けてください

インストール先
https://github.com/imxv/pretty-mermaid-skills(commit e234ab7) から pretty-mermaid という Skill を、すべてのプロジェクトで使えるように ~/.claude/skills/pretty-mermaid にインストールしてください(Codex は ~/.agents/skills/pretty-mermaid、Cursor は ~/.cursor/skills/pretty-mermaid)。まず全ファイルを見せて、スクリプトがあるか、パソコンの設定を変更しないかを教えてください。そのあとインストール先のフルパスを伝えて、私が OK するまで待ってください。
https://github.com/imxv/pretty-mermaid-skills(commit e234ab7) から pretty-mermaid という Skill を、このチャットで開いているプロジェクトにインストールしてください(.claude/skills/pretty-mermaid に。Codex は .agents/skills/pretty-mermaid、Cursor は .cursor/skills/pretty-mermaid)。まず全ファイルを見せて、スクリプトがあるか、パソコンの設定を変更しないかを教えてください。そのあとプロジェクト名とインストール先のフルパスを伝えて、私が OK するまで待ってください。

1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます

AI は先に何をするか説明し、各ステップで許可を求めます

Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com

Terminal を使う方へ

Gemini CLI や GitHub Copilot など Agent Skills 対応の他のアプリはフォルダが違います。そのアプリのガイドを見て、SKILL.md のあるフォルダをコピーしてください。

GitHub で見る ↗

2026年11月11日 に Claude Code、Codex、Cursor の公式ガイドで skill フォルダを確認

✓ コマンド確認済み 2026年11月19日

元の SKILL.md を見る

以下は提供元の 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 |

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

GitHub の情報

GitHub スター
1,589
提供元
imxv
ライセンス
MIT
最終コード更新
2026年8月22日
repo 内の SKILL.md(翻訳版とテンプレートを含む)
1
トピック
agent-skills, ai-agents, ascii-art, claude-code, codex, cursor, diagram-generator, documentation, flowchart, mermaid, mermaid-diagram, skills