Agent Doctor

プロジェクト内のエージェント指示ファイル(AGENTS.md、CLAUDE.md、GEMINI.md)やスキル定義を静的解析し、配線の問題を検出します。また、ローカルセッションログでほとんど呼び出されていないスキルを報告します。「スキルが読み込まれない」「エージェント設定を確認して」「スキル診断」「使っていないスキルはどれ?」といった質問に役立ちます。

Agent Doctor とは?

Agent Doctor は、エージェントの指示ファイル(AGENTS.md、CLAUDE.md、GEMINI.md)とスキル定義の静的解析を行い、スキルの発見や配線に関する問題を診断するスキルです。ファイルシステム上の実際のファイルのみを参照し、スキルの読み込みや有効化は行いません。`python3 scripts/agent_doctor.py --project <path> --format markdown` を実行することで、発見されたエージェント指示ファイル、許可されたスキルフォルダ、モデル名の不一致などを Markdown 形式で報告します。`--usage` オプションではセッションログを読み取り、ほとんど呼び出されていないスキルをカウントして表示します。このスキルは Claude Code、Codex、Cursor、Gemini など複数のエージェントプラットフォームに対応しており、診断結果に基づいてスキルの更新やアーカイブを提案します。

対応✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode✓Windsurf
npx skills add https://github.com/evemcgivern/agent-skills/tree/HEAD/plugins/agent-workflow/skills/agent-doctor

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Agent Doctor は何をしますか?

このスキルは、実際に存在するファイルに基づいてエージェントの指示とスキル発見の診断を行います。報告するソースは発見されたもののみであり、実行時に読み込まれたり、設定によって利用可能になったものは含まれません。

最初に決定論的スキャンを実行し、その後はレポートとレポートに記載されたファイルのみから推論してください。スキャンは読み取り専用であり、ファイルを修正したり、スキルを読み込んだり、権限を要求したり、一般的なホーム、環境、認証情報、認証ファイルを読み取ることはありません。

このスキルのインストールディレクトリから、次のコマンドを実行します:

python3 scripts/agent_doctor.py --project <path-to-project> --format markdown

フィクスチャまたは代替のグローバル発見パスを指定するには --home /fixture/home を使用します。追加で許可するスキルルートを指定するには --skill-root /path/to/skills を明示的に追加します。--model <name> は実行中のモデル(任意のリテラル名、例:Claude、claude-opus-5-5、GPT-5)を受け取り、通常のスキル文章内の「You are 」という識別子と比較します。比較では大文字小文字、ハイフンとスペース・ドットの違い、先頭の claude- を無視し、不一致があればアドバイザリとして報告します。このチェックをスキップするにはこのオプションを省略します。機械可読な出力には --format json を選択します。焦点を絞った診断のためにスキャン範囲を制限するには、--max-files、--max-bytes、--max-directories を使用します。

スキャンは深さ、ディレクトリ、ファイル、バイト数を制限し、依存関係、バージョン管理、キャッシュ、ワークツリーのディレクトリをスキップします。親階層やネストされた AGENTS.md / CLAUDE.md / GEMINI.md、許可されたグローバル指示ファイル(~/.codex/AGENTS.md、~/.claude/CLAUDE.md、~/.gemini/GEMINI.md)、およびすべてのドキュメント化されたホストフォルダ内のフラットスキルフォルダ(ホーム内:.agents、.codex、.claude、.gemini、.cursor、.copilot、.codeium/windsurf のスキル、プロジェクト内:.agents、.codex、.claude、.gemini、.cursor、.github、.opencode、.cline、.clinerules、.devin、.windsurf のスキル)を認識します。複数のフォルダ(例:Skills CLI のシンボリックリンク)から到達可能なスキルは1回だけ報告されます。標準パスとエイリアスは別々に保持し、シンボリックリンクによるエスケープを拒否し、生のファイル内容は出力しません。

スキルの使用状況とアーカイブ

ほとんど呼び出されていないスキルについては、python3 scripts/agent_doctor.py --usage を実行し、references/usage.md に従ってください。セッションログを読み取り専用で読み込み、スキル名と回数のみを表示します。オーナーに表を見せた後、スキルごとに「更新」「維持」「アーカイブ」を尋ねてください。「ログに呼び出しが見つかりませんでした」とは言っても「未使用」とは言わないでください。アーカイブは scripts/skill_archive.py を使用してのみ行います:plan を実行し、内容を表示し、そのスキルに対して明示的な同意を得てから archive --yes を実行します。質問と同じターンで実行しないでください。restore についても言及してください。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

evemcgivern/agent-skills

Reconsiders a project or shelved idea against current capabilities, proposes three ambitious outcomes, and designs an experiment for the hardest uncertainty. Use when asked "what more is now feasible", "is this worth attempting now", "revisit this shelved idea", or "think bigger about this project".

evemcgivern/agent-skills

Review an external PDF, image, screenshot, article, or URL against a repository's current issues and code to sort its ideas into new, already tracked, shipped, contradicted, or unverifiable, read-only by default. Use when the user asks to '/check-worth' or '$check-worth' a source, or asks whether an external idea is worth pulling into a repository as an issue or code change.

evemcgivern/agent-skills

Routes each task to a suitable model tier in Claude Code, Codex, or another agent that can start subagents on a chosen model (for example Gemini CLI or Antigravity CLI), following the user's routing preferences. Keeps small tasks local, delegates discovery, routine coding, and testing to cheaper subagents, and sends difficult decisions and risky reviews to a stronger one. Use when deciding whether to delegate, writing subagent handoffs, or setting routing preferences, or when asked to "save tokens", "use cheaper models", "fan out subagents", "stay inside my quota", or "efficient-frontier-routing help".

evemcgivern/agent-skills

Makes the most expensive model in a session the senior decision-maker, keeping its reasoning for intent, architecture, decomposition, tradeoffs, final review, and synthesis while cheaper agents handle discovery, implementation, tests, logs, and verification. Use when the active agent is Fable or another top-tier model, or when asked to "act as chief agent", "delegate the grunt work", or "save the expensive model for decisions".

関連スキル