PR Visualize

GitHub の PR を入力に、変更されたコードやドキュメントを mermaid の図(全体像・関数単位のシーケンス図・参照箇所起点のシーケンス図)で可視化し、短い解説を付けて Markdown ファイルに書き出す。stacked PR では、スタックの全体像と、現在の段を強調した変更の全体像を描く。`/pr-visualize` の明示起動のみ。`--comment` で PR コメントへ投稿(承認必須)。レビューの指摘は行わない。GitHub(gh) 前提。

9 starsGit & Code Review Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add yasunori0418/skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add yasunori0418/skills --skill pr-visualize
Manual install
git clone --depth 1 https://github.com/yasunori0418/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/github/pr-visualize ~/.claude/skills/pr-visualize

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# pr-visualize — PR の変更を図で解説する

差分は行の増減しか見せない。読み手が知りたいのは「どんなデータが入り、何をして、何が出るか」と
「それが呼び出し元の挙動をどう変えるか」。このスキルは PR を読み、その 2 点をシーケンス図にして、
図から読み取れないことだけを短い文章で補う。

- 図の描き方: `references/mermaid.md`
- 解説の構成と文章の規則: `references/writing.md`

`<skill-dir>` はこのファイルのあるディレクトリ。収集・検証・投稿は `scripts/pr-visualize.sh` に任せ、
gh や git を手で並べ直さない。

## 引数

`$ARGUMENTS` から次を読み取る。

- PR の指定: URL、`#N`、`pr:N`。省略時は現在ブランチの PR。以下 `<PR>` と書く。
- `--comment`: 解説を PR コメントへ投稿する(手順 8)。

PR になっていないローカルの差分は対象外。その場合は diff-review を案内して終える。

## 出力先

解説と中間ファイルは一時的な成果物。置き場所は次の順で決める。以下 `<out-dir>` と書く。

1. tmp-output スキルがあれば、その手順で決める。
2. 無ければ、ユーザーやプロジェクトが決めている運用に従う。
3. それも無ければ、使っているコーディングエージェントの一時出力の慣例に従う。

ファイル名は次のとおり。再実行時は上書きする。

- `pr-<番号>-visualize.md`: 解説
- `pr-<番号>-visualize.diff`: 退避した差分
- `pr-<番号>-visualize.comment.md`: 投稿用の本文(`--comment` のときだけ)

## 手順

### 1. PR を把握する

```bash
bash <skill-dir>/scripts/pr-visualize.sh preflight "<PR>"
```

タイトル・本文・コミットメッセージ(見出しだけ。本文も要るなら `--full`)・変更ファイルの統計が出る。
次の 3 つを控える。

- **MODE**: `full` は PR のリポジトリが作業ディレクトリの remote と一致した状態。`degraded` は一致しない状態で、
  差分の外のコードを読めない。`degraded` では手順 3 と参照箇所起点の図を省き、`--comment` は実行しない。
- **TOOLS**: `mmdc` が無いと図を構文検証できない。その場合は解説に「未検証」と書く。
- **STACK**: `size` が 2 以上なら stacked PR。次のコマンドで、各段の変更ファイルとスタックの図を取る。
  検出できるのは GitHub のスタック機能に登録された PR だけ。それ以外は単独の PR として扱う。

  ```bash
  bash <skill-dir>/scripts/pr-visualize.sh stack "<PR>"
  ```

  スタックでも、図にするのは現在の PR の変更だけ。差分(手順 2)と変更前の状態(手順 3)は、
  1 つ下の段までを含んだ状態が基準になる。

`ERROR:` が出たら(未認証、PR が見つからないなど)、先にそれを解決する。
Read the full skill on GitHub

Details

Skill name
pr-visualize
Path
skills/github/pr-visualize/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the PR Visualize skill do?

GitHub の PR を入力に、変更されたコードやドキュメントを mermaid の図(全体像・関数単位のシーケンス図・参照箇所起点のシーケンス図)で可視化し、短い解説を付けて Markdown ファイルに書き出す。stacked PR では、スタックの全体像と、現在の段を強調した変更の全体像を描く。`/pr-visualize` の明示起動のみ。`--comment` で PR コメントへ投稿(承認必須)。レビューの指摘は行わない。GitHub(gh) 前提。

How do I install the PR Visualize skill?

Claude Code plugin: /plugin marketplace add yasunori0418/skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is PR Visualize popular?

It lives in yasunori0418/skills, which has 9 GitHub stars and 0 forks.

Related skills

Agent Teams

9

yasunori0418/skills

Claude Code の並列エージェント(agent teams・teammate)の後始末と無応答時の打ち切りルール。`name` を付けて Agent を起動するとき、TeamCreate でチームを組むとき、teammate から `idle_notification` が届いたとき、評価ループ等で次のイテレーションのエージェントを起動する前、エージェントの返信が届かないときに参照する。`name` を付けない通常のサブエージェント起動だけなら対象外。

AI, LLMs & Agents

Basic Design

9

yasunori0418/skills

spec.md の REQ-# を入力に、機能一覧・モジュール構成・インターフェース・データフローを持つ docs/dev/<対象>/basic-design.md を作成・改訂するスキル。/basic-design <対象名> で明示的に呼び出されたときのみ使用する。

Writing & Content

Biz Translate

9

yasunori0418/skills

技術的な内容を、技術用語を排したビジネス職向けの平易な説明文に翻訳する。`/biz-translate` と明示的に呼ばれたときのみ実行する。

Writing & Content

Product Naming

9

yasunori0418/skills

プロダクトの役割と目的に合う名前の案を出し、既存のパッケージ・GitHub・同じ分野の製品との重なりを確かめ、比較表で比べて決定を記録するスキル。新しいプロダクトの命名と、既存のプロダクトの改名の検討の両方に使う。/product-naming で明示的に呼び出されたときのみ使用する。

Git & Code Review

PR Create

9

yasunori0418/skills

Pull Request / Merge Request を作成するときに必ず参照する。`gh pr create`/`glab mr create` で PR/MR を作る、コミット済みの作業をレビューに出す、並列・stacked 作業の各ブランチで PR を起こす、といった場面で使う。リポジトリの pull_request_template/merge_request_template を決定論スクリプトで検出して優先し、テンプレの骨組み(見出し・チェックリスト・順序)を改変せず入力箇所を埋めるだけにする(作成前に骨組み照合ゲートで機械検証)。無ければ汎用観点で本文を構成。本文の素材は対象リポジトリの git 差分のみに限定し、他リポジトリ・他タスクの内容を混入させない。draft 既定。head が保護ブランチ(GitHub 上・origin/HEAD の既定ブランチ、main・master・develop・trunk・release 系など)のときだけ push と作成の前にユーザー承認を取り、それ以外は確認せず push して作成する。GitHub(gh) 基本、GitLab(glab) 等にも対応。

Git & Code Review

Rebase Flow

9

yasunori0418/skills

git rebase / git pull --rebase を伴う操作の安全運用ルール。履歴書き換えは復旧不能な事故になり得るため、rebase 系コマンドを 1 つでも実行する前に必ず本スキルを参照する。「rebase して」「main に追従して」「ブランチを最新化して」「コミットをまとめて / 整理して」「squash して」「fixup を畳んで」「履歴をきれいにして」「force-push して」と依頼される、PR 前に履歴を整える、コンフリクト解消のために rebase する、といった場面すべてが対象。決定論スクリプトによるガードレール判定(保護ブランチ・push 済み範囲・子ブランチ・進行中操作・コンフリクト予測)→ 計画提示 → ユーザー承認 → backup ブランチ作成 → 非対話実行 → range-diff / tree 同一性による機械検証、のゲートを固定化する。plugin hooks の git-guard により backup 作成(解錠)なしの git rebase は機械的にブロックされる。

Git & Code Review

Browse the most popular Claude skills, all git & code review skills, or write your own with the skills generator.