by fkubota
Claude Code の出力・PR・コードを、付箋のホワイトボードで寄り道しながら理解する /understand スキル
# Add to your Claude Code skills
git clone https://github.com/fkubota/understand-modeGuides for using ai agents skills like understand-mode.
Last scanned: 11/22/2026
{
"issues": [
{
"file": "README.md",
"line": 17,
"type": "dangerous-command",
"message": "Dangerous command (disables permission prompts): \"bypassPermissions\"",
"severity": "medium"
}
],
"status": "PASSED",
"scannedAt": "2026-11-22T12:18:36.304Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how understand-mode compares with popular alternatives.
understand-mode is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by fkubota. Claude Code の出力・PR・コードを、付箋のホワイトボードで寄り道しながら理解する /understand スキル. It has 68 GitHub stars.
Yes. understand-mode passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/fkubota/understand-mode" and add it to your Claude Code skills directory (see the Installation section above).
understand-mode is primarily written in JavaScript. It is open-source under fkubota on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh understand-mode against similar tools.
No comments yet. Be the first to share your thoughts!
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
Claude Code の出力を、付箋のホワイトボードで寄り道しながら理解するためのスキルです。
わからない文を選ぶと、その場に付箋が生えます。付箋の中では、メインの文脈を引き継いだ分身が答えます。メインの会話は汚れません。

bypassPermissions)で使っているときは、アプリも聞き返しません。提案されたSQLはそのまま実行されますclaude コマンド)gh コマンド(なければブランチの差分で代わりにします)gh があれば使いますが、作者の環境では GitHub につなげなかったため、ブランチ差分での代替手順でしか試していません追加の npm パッケージは不要です。図とグラフのライブラリは同梱しています(ネット接続がなくても描画できます)。
動作を確認しているのは macOS と Linux です。Windows では試していません。
git clone https://github.com/fkubota/understand-mode.git
cd understand-mode
bash install.sh
~/.claude/skills/understand/ にコピーされます。Claude Code を開き直すと /understand が使えます。
/understand
/understand このPRを理解したい、/understand #128のPR、/understand 認証の流れを理解したい
→ メインのClaudeが調べて、概要→変更のまとまり→必要な分だけのコード抜粋→読むときのポイント の順に説明文書を作ってから開きます/understand -1 このPRを理解したい(本文はそのまま、段落の合間に図とグラフが入ります)/understand -2 このPRを理解したい(図を主役に、本文も組み替えます)/understand/understand src/report.py/understand diff(ブランチとの差分は /understand diff main)| 操作 | やり方 |
|---|---|
| 付箋を作る | 本筋や付箋の回答の文を選択 → メニュー |
| 続けて質問 | 付箋の入力欄で ⌘/Ctrl + Enter |
| 付箋を動かす | 付箋の見出しをドラッグ |
| たたむ・開く | 「たたむ」ボタン/たたんだタブをクリック。まとめて片付けたいときは上の「すべてたたむ」 |
| 付箋の大きさを変える | 右の辺で横、下の辺で縦、右下の角で両方をドラッグ(ダブルクリックで元に戻ります) |
| ボードを動かす | 背景をドラッグ、またはスクロール |
| 拡大・縮小 | ⌘/Ctrl + スクロール、または下のツールバー |
| グラフの値を質問 | グラフの点や棒をクリック |
設定ファイルはありません。モデルも道具もSQLの書き方も、分身がメインのセッションから引き継ぎます。
変えられるのは待ち時間だけです。重い調べものに時間がかかるようなら、UNDERSTAND_TIMEOUT_SEC=600 のように環境変数で伸ばせます(既定は300秒)。
claude -p --resume <メインのセッション> --fork-session を実行します。メインの文脈を引き継いだ分身が答えるので、メインの会話は汚れません~/.claude/projects/ の該当ファイル)だけを削除します。メインのセッションには触れませんlow で動きます。寄り道を軽く回すためですselect(または with)で始まる1文だけです。書き込みや複数文はアプリ側で弾きますBash とファイル編集の禁止です。psql や bq のようなコマンド系は止まりますが、MCPの道具は名前が分からないので止めきれません。MCP経由でデータを取っている方はご注意くださいrm -rf ~/.claude/skills/understand
続きの開発は CLAUDE.md と docs/architecture.md から読んでください。npm run mock で、費用をかけずに画面を動かせます。
npm run mock # 偽の claude で起動(費用ゼロ)
npm run test:sql # SQL実行まわりの確認(ClaudeもDBも使わない)
npm i && npm run test:e2e # mock を動かしたまま、画面を一通り自動操作
デモのGIFは docs/media/demo.gif です。差し替えるときは同じパスに置いてください。
MIT(LICENSE を参照)。同梱しているライブラリは skill/understand/app/public/vendor/LICENSE-* を参照してください。