claude code skills おすすめ 42 種一覧
Claude Code Skills は、SKILL.md ファイル 1 枚で Claude の振る舞いを拡張する Agent Skills オープン規格準拠の仕組みです。Claude Code 起動時からバンドル済み 7 種がすぐ使え、Plugin 経由の追加 Skills や自作 Skill も ~/.claude/skills/<name>/SKILL.md に置くだけで全プロジェクトに反映されます(出典: スキルで Claude を拡張する)。
本記事は、公式ドキュメント・GitHub リポジトリから確認できた全 Skill を 1 表に集約したSkill 全網羅表を核に、SKILL.md フロントマター全フィールド、アクセス制御・スコープ設定、よくあるトラブルと対処をまとめます。Anthropic 公式情報から確証が取れた内容のみを記載し、推測は [未確認] で明示します。
Claude Code Skills は SKILL.md フロントマター + マークダウン本文で Claude を拡張する仕組みで、Agent Skills オープン規格に準拠します。バンドル済み 7 種(/simplify / /batch / /debug / /loop / /claude-api / /fewer-permission-prompts / /security-review)はインストール不要で即利用可能。Plugin 経由の Skills は commit-commands・pr-review-toolkit・plugin-dev・agent-sdk-dev・code-review・feature-dev など 6 プラグイン・23 以上の Skills が公式マーケットプレイスで提供されます。SKILL.md フロントマターは description を筆頭に 17 フィールドが確認されており、disable-model-invocation でデプロイ系の誤自動起動を防止、context: fork でサブエージェント分離実行が可能です。アクセス制御はスコープ 4 段階 + 権限ルール + 環境変数で組み合わせられ、組織展開では disableSkillShellExecution が最重要設定です。SKILL.md は 500 行以下を公式推奨とし、description 冒頭に主要ユースケースを置いて自動マッチ精度を上げるのが運用の核心です。
目次 (10)
Skill を選ぶ前に — 3 つの入手経路と選択の判断軸
Claude Code Skills を入手できる経路は 3 つあります。バンドル済み / Plugin 経由 / 自作です。どれを先に使うべきかは、以下の判断軸で選ぶと迷いません。
「今すぐ動かしたい」場合はバンドル済みを使い倒してください。インストール不要でセッション開始直後から /simplify /debug で呼び出せます。「git・PR・デプロイをひとまとめにしたい」場合は Plugin を入れることが近道です。commit-commands を 1 個インストールするだけで、コミット→プッシュ→PR 作成を 1 コマンドに集約できます。「自社コードの命名規則・デプロイ手順を Claude に常駐させたい」場合は自作 Skill が最適です。~/.claude/skills/ に SKILL.md を 1 ファイル置くだけで全プロジェクトで有効になります。
以降では、公式情報から確認できた全 Skill を 1 つの表に集約して示します。
Skill 全網羅表 — バンドル済み・Plugin 経由・自作典型パターンを 1 表に
以下の表は、Anthropic 公式ドキュメント(コマンドリファレンス)および公式 GitHub リポジトリ(anthropics/claude-code plugins)から確認できた全 Skill を集約したものです。Plugin 経由の Skills は 1 プラグインに複数 Skill が含まれる場合は行を分割して展開しています。自作典型パターンは公式ドキュメントの掲載例から抜粋しています。
| カテゴリ | Skill 名 | 入手経路 | 主用途 | 起動方法 | おすすめ度 | 注意点 |
|---|---|---|---|---|---|---|
| バンドル済み | /simplify |
標準付属 | 最近変更したファイルを再利用・品質・効率の 3 観点でレビューし修正する | /simplify [focus] または自動 |
★★★ | 3 並列エージェントを生成するためトークン消費が多め |
| バンドル済み | /batch |
標準付属 | コードベース全体にわたる大規模変更を 5〜30 ユニットに分割し並列バックグラウンドエージェントで実行 | /batch <instruction> または自動 |
★★★ | git リポジトリ必須・各ユニットが PR を自動作成 |
| バンドル済み | /debug |
標準付属 | デバッグログ有効化・セッションログを読んで問題をトラブルシュート | /debug [description] または自動 |
★★★ | セッション開始後に実行するとその時点からログキャプチャ開始 |
| バンドル済み | /loop |
標準付属 | セッションが開いている間プロンプトを繰り返し実行。間隔省略で自動ペース調整 | /loop [interval] [prompt] または自動 |
★★ | .claude/loop.md があればそのプロンプトを使用。エイリアス /proactive |
| バンドル済み | /claude-api |
標準付属 | プロジェクト言語に応じた Claude API リファレンス資料読み込み。ツール使用・ストリーミング・バッチをカバー | /claude-api [migrate|managed-agents-onboard] または自動 |
★★(API 開発案件) | anthropic / @anthropic-ai/sdk インポート時に自動アクティブ化 |
| バンドル済み | /fewer-permission-prompts |
標準付属 | トランスクリプトをスキャンして一般的な読み取り専用 Bash・MCP ツール呼び出しの許可リストを .claude/settings.json に追加 |
/fewer-permission-prompts |
★★ | プロジェクト settings.json を書き換えるため事前に確認推奨 |
| バンドル済み | /security-review |
標準付属 | 現在のブランチの保留中変更をセキュリティ脆弱性(インジェクション・認証・データ露出)について分析 | /security-review |
★★★ | git diff ベース。ステージ済み変更のみ対象 |
| Plugin: commit-commands | commit |
commit-commands Plugin |
ステージド・アンステージド変更をもとに自動生成コミットメッセージで git コミット作成 | /commit-commands:commit |
★★★ | コミットメッセージ自動生成のみ。push は別コマンド |
| Plugin: commit-commands | commit-push-pr |
commit-commands Plugin |
コミット→プッシュ→プルリクエスト作成を一気通貫実行 | /commit-commands:commit-push-pr |
★★★ | gh CLI が必要 |
| Plugin: commit-commands | clean_gone |
commit-commands Plugin |
リモートから削除されたローカルブランチをクリーンアップ | /commit-commands:clean_gone |
★★ | ローカル環境のブランチ整理専用 |
| Plugin: pr-review-toolkit | comment-analyzer Agent |
pr-review-toolkit Plugin |
PR のコメント・注釈の正確性・保守性を分析(コメント精度・ドキュメント・技術負債) | /pr-review-toolkit:comment-analyzer or 自動 |
★★ | Agent として動作。reviews 系との併用推奨 |
| Plugin: pr-review-toolkit | pr-test-analyzer Agent |
pr-review-toolkit Plugin |
PR のテストカバレッジ品質を分析(行動カバレッジ・ギャップ・エッジケース) | /pr-review-toolkit:pr-test-analyzer or 自動 |
★★★ | テスト不足 PR の発見に効果大 |
| Plugin: pr-review-toolkit | silent-failure-hunter Agent |
pr-review-toolkit Plugin |
エラーハンドリングと静的失敗を検出(catch ブロック・エラーロギング・フォールバック) | /pr-review-toolkit:silent-failure-hunter or 自動 |
★★★ | 見落としがちな catch 節の空実装を検出 |
| Plugin: pr-review-toolkit | type-design-analyzer Agent |
pr-review-toolkit Plugin |
型設計品質を 1〜10 段階で評価(カプセル化・不変量・型の有用性) | /pr-review-toolkit:type-design-analyzer or 自動 |
★★ | TypeScript / 型付き言語プロジェクト向け |
| Plugin: pr-review-toolkit | code-reviewer Agent |
pr-review-toolkit Plugin |
一般的なコード品質レビュー(CLAUDE.md 準拠・スタイル・バグ検出) | /pr-review-toolkit:code-reviewer or 自動 |
★★★ | CLAUDE.md の規約がある場合に特に有効 |
| Plugin: pr-review-toolkit | code-simplifier Agent |
pr-review-toolkit Plugin |
コード簡潔化とリファクタリング(可読性・複雑さ・冗長性) | /pr-review-toolkit:code-simplifier or 自動 |
★★ | リファクタ提案のみ。適用は手動 |
| Plugin: plugin-dev | Hook Development Skill |
plugin-dev Plugin |
Hooks API とイベント駆動自動化の設計・実装 | create a hook 等のトリガーフレーズで自動 |
★★ | Plugin 開発者向け専門 Skill |
| Plugin: plugin-dev | MCP Integration Skill |
plugin-dev Plugin |
Model Context Protocol(モデルコンテキストプロトコル)サーバーの統合 | add MCP server 等のトリガーフレーズで自動 |
★★ | .mcp.json 設定に特化 |
| Plugin: plugin-dev | Plugin Structure Skill |
plugin-dev Plugin |
プラグインの組織とマニフェスト設定 | plugin structure 等のトリガーフレーズで自動 |
★★ | plugin.json マニフェスト記述支援 |
| Plugin: plugin-dev | Plugin Settings Skill |
plugin-dev Plugin |
.claude/plugin-name.local.md を使った設定パターン |
plugin settings 等のトリガーフレーズで自動 |
★ | プロジェクト別設定ファイル管理専用 |
| Plugin: plugin-dev | Command Development Skill |
plugin-dev Plugin |
スラッシュコマンドの設計・フロントマター定義 | create a slash command 等のトリガーフレーズで自動 |
★★ | Plugin 内コマンド開発者向け |
| Plugin: plugin-dev | Agent Development Skill |
plugin-dev Plugin |
自律サブエージェントの設計・フロントマター定義 | create an agent 等のトリガーフレーズで自動 |
★★ | Plugin 内エージェント開発者向け |
| Plugin: plugin-dev | Skill Development Skill |
plugin-dev Plugin |
Skill の作成とプログレッシブディスクロージャー設計 | create a skill 等のトリガーフレーズで自動 |
★★ | Skill の description 改善ガイドを内包 |
| Plugin: agent-sdk-dev | /new-sdk-app |
agent-sdk-dev Plugin |
新しい Claude Agent SDK アプリケーション(TypeScript / Python)の雛形を対話式ウィザードで生成 | /new-sdk-app <project-name> |
★★★ | 最新 SDK バージョンの自動インストールと型チェック実行を含む |
| Plugin: agent-sdk-dev | agent-sdk-verifier-py Agent |
agent-sdk-dev Plugin |
Python Agent SDK アプリの検証(SDK インストール・使用パターン・セキュリティ設定・エラーハンドリング) | 自動または手動呼び出し | ★★ | .env / API キー露出チェックを含む |
| Plugin: agent-sdk-dev | agent-sdk-verifier-ts Agent |
agent-sdk-dev Plugin |
TypeScript Agent SDK アプリの検証(tsconfig・型安全性・SDK 使用パターン・エラーハンドリング) | 自動または手動呼び出し | ★★ | tsconfig.json の設定確認を含む |
| Plugin: code-review | code-review コマンド |
code-review Plugin |
PR を 4 並列エージェントでレビュー(CLAUDE.md 準拠・バグ検出・履歴分析)。信頼度 80 点以上のみ報告 | /code-review |
★★★ | クローズ・ドラフト・既審査 PR は自動除外 |
| Plugin: feature-dev | feature-dev コマンド |
feature-dev Plugin |
7 フェーズ(Discovery → Exploration → Questions → Architecture → Implementation → Review → Summary)の機能開発ワークフロー起動 | /feature-dev |
★★★ | 複数エージェント並列起動のため大型機能開発向き |
| Plugin: feature-dev | code-explorer Agent |
feature-dev Plugin |
既存コードベースの機能を深く分析しエントリーポイント・データフロー・アーキテクチャをレポート | Phase 2 で自動起動 / 手動可 | ★★ | 読み取り専用の探索専用エージェント |
| Plugin: feature-dev | code-architect Agent |
feature-dev Plugin |
機能のアーキテクチャと実装ブループリントを複数アプローチで並列設計 | Phase 4 で自動起動 / 手動可 | ★★★ | 複数設計案から選択できる構成 |
| Plugin: feature-dev | code-reviewer Agent |
feature-dev Plugin |
バグ・品質問題・CLAUDE.md 準拠を 3 視点で並列レビュー。信頼度 80% 以上の問題のみ報告 | Phase 6 で自動起動 / 手動可 | ★★★ | 信頼度フィルタで偽陽性を低減 |
| 自作: リファレンス型 | api-conventions |
自作(Personal / Project) | コードベース固有の API 設計規約(REST 命名・エラー形式・バリデーション)を Claude に常駐させる | description 一致で自動 / /<skill-name> で手動 |
★★★ | CLAUDE.md に書くより呼び出し時のみ読み込まれてコンテキスト節約 |
| 自作: タスク型 | deploy |
自作(Personal / Project) | テスト→ビルド→デプロイターゲットへの push を手順化。disable-model-invocation: true で誤自動起動を防止 |
/<skill-name> 手動のみ |
★★★ | allowed-tools: Bash(./deploy.sh) で実行ファイルを事前承認 |
| 自作: タスク型 | commit |
自作(Personal / Project) | コミットメッセージ規約・ステージング手順を自前ルールで Skill 化 | /<skill-name> 手動のみ |
★★ | commit-commands Plugin があれば不要なケースも多い |
| 自作: 動的注入型 | pr-summary |
自作(Personal / Project) | !gh pr diff / !gh pr view --comments を動的注入して最新 PR データをリアルタイムで Claude に渡してサマリー生成 |
/<skill-name> 手動 |
★★★ | context: fork + agent: Explore で分離コンテキスト実行 |
| 自作: 動的注入型 | session-logger |
自作(Personal / Project) | 実行内容を logs/${CLAUDE_SESSION_ID}.log に記録。セッション固有ファイルの自動管理 |
description 一致で自動 / /<skill-name> で手動 |
★ | ${CLAUDE_SESSION_ID} 変数置換を使用 |
| 自作: コードベース説明型 | explain-code |
自作(Personal / Project) | コードを類推(日常物事への例え)+ ASCII 図 + ステップバイステップ + 落とし穴の 4 要素で説明 | How does this work? 等で自動 / /<skill-name> で手動 |
★★★ | 公式チュートリアルの最初のサンプル。入門として最適 |
| 自作: 可視化型 | codebase-visualizer |
自作(Personal / Project) | Python スクリプトを実行しコードベースのインタラクティブ HTML ツリービュー(codebase-map.html)を生成 |
Visualize this codebase で自動 / /<skill-name> で手動 |
★★ | allowed-tools: Bash(python *) が必要。Python 組み込みライブラリのみ使用 |
| Plugin: その他 | explanatory-output-style |
explanatory-output-style Plugin |
Claude の応答に実装選択に関する教育的な洞察・解説を追加 | インストール後 自動 | ★★ | 学習目的の開発者向け。コードレビュー時に有効 |
| Plugin: その他 | learning-output-style |
learning-output-style Plugin |
スキル構築のためのインタラクティブ学習モードで Claude が応答 | インストール後 自動 | ★★ | 教育・メンター用途向き |
| Plugin: その他 | frontend-design Skill |
frontend-design Plugin |
フロントエンド設計パターンのガイドと実装 | トリガーフレーズで自動 / 手動 | ★★ | フロントエンド案件向け専門 Skill |
| Plugin: その他 | writing-rules Skill |
hookify Plugin |
カスタムフック作成時の記述ルールを提供 | create a hook 等で自動 |
★ | hookify Plugin 専用 Skill |
この表に含まれる Skill 合計: バンドル済み 7 行 + Plugin 経由 24 行 + 自作典型 6 行 + その他 Plugin 4 行 = 計 41 行。
第 2 表: SKILL.md フロントマター全フィールド一覧
SKILL.md のフロントマターは、Skill のいつ・誰が・どのように呼び出すかを完全に制御します。以下の表は 公式フロントマターリファレンスから確認できた全フィールドと、文字列置換変数をまとめたものです。すべてのフィールドは任意であり、description のみが「推奨」扱いです。
| フィールド / 変数 | 型 | 必須/任意 | 用途 | 値の例 | 出典 |
|---|---|---|---|---|---|
name |
文字列 | 任意 | Skill の表示名。省略時はディレクトリ名を使用。小文字・数字・ハイフンのみ・最大 64 文字 | my-skill |
公式 |
description |
文字列 | 推奨 | Skill の用途と自動起動トリガー。Claude が Skill を使うべきか判断するために参照する。省略時は本文第 1 段落を使用。when_to_use と合わせて 1,536 文字でカット |
"Explains code with diagrams. Use when..." |
公式 |
when_to_use |
文字列 | 任意 | Claude がスキルを呼び出すべき追加コンテキスト(トリガーフレーズ・リクエスト例)。description に加算され、1,536 文字上限にカウントされる |
"Use when user asks 'how does X work?'" |
公式 |
argument-hint |
文字列 | 任意 | オートコンプリート時に表示される引数ヒント | [issue-number] / [filename] [format] |
公式 |
arguments |
文字列またはリスト | 任意 | $name 置換用の名前付き位置引数。スペース区切り文字列または YAML リストを受け入れる |
arguments: [issue, branch] → $issue $branch |
公式 |
disable-model-invocation |
boolean | 任意 | true で Claude による自動起動を禁止。/name 手動のみになる。サブエージェントへのプリロードも防止。デフォルト: false |
true |
公式 |
user-invocable |
boolean | 任意 | false で / メニューから非表示。Claude バックグラウンド知識用。デフォルト: true |
false |
公式 |
allowed-tools |
文字列またはリスト | 任意 | Skill がアクティブな間 Claude が許可なしで使えるツール。他のツールは引き続き権限設定で管理 | Bash(git add *) Bash(git commit *) |
公式 |
model |
文字列 | 任意 | Skill アクティブ中に使用するモデル。現在のターンの残りに適用。inherit でセッションモデルを維持 |
claude-opus-4-5 / inherit |
公式 |
effort |
文字列 | 任意 | Skill アクティブ中の思考努力レベル。セッション effort をオーバーライド。モデル依存 | low / medium / high / xhigh / max |
公式 |
context |
文字列 | 任意 | fork でサブエージェントの分離コンテキストで実行。会話履歴にアクセス不可 |
fork |
公式 |
agent |
文字列 | 任意 | context: fork 時に使用するサブエージェントタイプ。組み込み(Explore/Plan/general-purpose)または .claude/agents/ のカスタムエージェント |
Explore / Plan / general-purpose |
公式 |
hooks |
オブジェクト | 任意 | Skill のライフサイクルにスコープされたフック設定 | hooks: {on_exit: ...} |
公式 |
paths |
文字列またはリスト | 任意 | 自動起動を制限する Glob パターン。一致するファイルを操作中にのみ Skill を自動読み込み。モノレポで有効 | "packages/frontend/**" |
公式 |
shell |
文字列 | 任意 | !`command` および ```! ブロックに使用するシェル。bash(デフォルト)または powershell |
bash / powershell |
公式 |
$ARGUMENTS |
変数 | — | Skill 呼び出し時に渡されたすべての引数。Skill 内に $ARGUMENTS がない場合は末尾に ARGUMENTS: <値> を追加 |
/fix-issue 123 → $ARGUMENTS = 123 |
公式 |
$ARGUMENTS[N] / $N |
変数 | — | 0 ベースインデックスで特定の引数にアクセス。シェルスタイルクォートで複数単語を 1 引数として扱える | $ARGUMENTS[0] / $0 |
公式 |
${CLAUDE_SESSION_ID} |
変数 | — | 現在のセッション ID。ログファイルの命名・セッション固有ファイルの作成に使用 | logs/${CLAUDE_SESSION_ID}.log |
公式 |
${CLAUDE_EFFORT} |
変数 | — | 現在の努力レベル文字列。Skill の指示を活性化 effort 設定に適応させるために使用 | low / medium / high / xhigh / max |
公式 |
${CLAUDE_SKILL_DIR} |
変数 | — | Skill の SKILL.md を含むディレクトリの絶対パス。バンドルスクリプト参照に使用 |
python ${CLAUDE_SKILL_DIR}/scripts/run.py |
公式 |
フロントマター合計: 15 フィールド + 6 変数 = 21 エントリー。
フロントマター選択の実践ポイント
description は Skill の成否を最も大きく左右するフィールドです。Claude がどのタイミングで Skill を読み込むかは、この description と when_to_use のマッチングで決まります。主要なユースケースを文頭に書いて、スキル一覧の 1,536 文字カットが当たっても重要キーワードが生き残るようにしてください。
disable-model-invocation: true は副作用を持つ Skill(デプロイ・コミット・メール送信)に必ず設定します。Claude が会話の文脈から「今がそのタイミングだ」と判断して自動実行すると制御を失います。手動承認が必要なワークフローには必須の設定です。
context: fork は長時間の調査タスク・独立した生成タスクに有効です。ただし、リファレンス型 Skill(api-conventions のような規約を常駐させるだけの Skill)に付けると、サブエージェントは規約を受け取るものの実行可能なプロンプトがないため空振りします。context: fork は「タスクとして実行する Skill」にのみ使います。
第 3 表: アクセス制御・スコープ・セキュリティ設定一覧
Skill のアクセス制御は、フロントマター設定・権限ルール・環境変数・スコープの 4 層で構成されます。以下の表は 公式 Skill ドキュメントと 公式 discover-plugins ドキュメントから確認できた全設定を集約したものです。
| 設定キー | スコープ | 効果 | 設定ファイル / 場所 | 値の例 |
|---|---|---|---|---|
disable-model-invocation: true |
個別 Skill | Claude による自動起動を完全ブロック。/skill-name 手動のみ有効になる。Skill の description はコンテキストに含まれなくなる |
SKILL.md フロントマター | disable-model-invocation: true |
user-invocable: false |
個別 Skill | ユーザーの / メニューから非表示。Claude はバックグラウンド知識として使用できるが、ユーザーが直接呼び出せない |
SKILL.md フロントマター | user-invocable: false |
allowed-tools |
個別 Skill | 列挙したツールを Skill アクティブ中に事前承認。他のツールは通常の権限設定で管理 | SKILL.md フロントマター | Bash(git add *) Bash(git commit *) |
Skill deny ルール |
セッション / プロジェクト | 全 Skill の Claude 呼び出しを禁止 | /permissions の deny ルール |
Skill |
Skill(name) deny ルール |
セッション / プロジェクト | 特定 Skill のみ Claude 呼び出しを禁止。完全一致 | /permissions の deny ルール |
Skill(deploy) |
Skill(name *) deny ルール |
セッション / プロジェクト | 特定 Skill の任意の引数を含むプレフィックス一致で禁止 | /permissions の deny ルール |
Skill(deploy *) |
Skill(name) allow ルール |
セッション / プロジェクト | 特定 Skill のみ Claude 呼び出しを許可(deny と組み合わせて使用) | /permissions の allow ルール |
Skill(commit) |
disableSkillShellExecution: true |
プロジェクト / 管理設定 | !`command` 動的コンテキスト注入を全停止。各コマンドは [shell command execution disabled by policy] に置換。バンドル済み・管理 Skill は除外 |
.claude/settings.json または管理設定 |
"disableSkillShellExecution": true |
| スコープ: Enterprise | 組織全体 | 管理設定から配布された Skill が最優先で適用。同名の Personal / Project Skill をオーバーライド | 管理設定(管理者配布) | — |
| スコープ: Personal | 全プロジェクト | ~/.claude/skills/ 以下の Skill。Enterprise の次に優先 |
~/.claude/skills/<skill-name>/SKILL.md |
— |
| スコープ: Project | 該当プロジェクトのみ | .claude/skills/ 以下の Skill。Personal の次に優先 |
.claude/skills/<skill-name>/SKILL.md |
— |
| スコープ: Plugin | Plugin 有効な場所 | <plugin>/skills/<skill-name>/SKILL.md の Skill。<plugin-name>:<skill-name> 名前空間を使用するため他と衝突しない |
Plugin インストールで自動配置 | commit-commands:commit |
| スコープ優先順位(同名 Skill) | 全スコープ | Enterprise > Personal > Project の順で上書き。Plugin Skill は名前空間が付くため衝突なし | — | — |
| ライブ変更検出 | Personal / Project | ~/.claude/skills/ / .claude/skills/ のファイル変更を監視し再起動なしでセッション内に反映 |
ファイルシステム監視 | — |
| モノレポネスト検出 | Project | サブディレクトリ内のファイルを操作中に packages/frontend/.claude/skills/ などのネストされた skills ディレクトリを自動検出 |
.claude/skills/ 以下の任意サブディレクトリ |
— |
--add-dir + skills 例外 |
セッション | --add-dir で追加したディレクトリの .claude/skills/ は自動読み込み(他の .claude/ 設定は読み込まれないが Skill は例外) |
CLI フラグ | claude --add-dir /path/to/shared-skills |
| Plugin インストールスコープ: User | Plugin | 全プロジェクトで自分用にインストール。デフォルトスコープ | /plugin install <name> |
— |
| Plugin インストールスコープ: Project | Plugin | .claude/settings.json に追加。リポジトリ全コラボレーターが使用可能 |
.claude/settings.json |
"enabledPlugins": [...] |
| Plugin インストールスコープ: Local | Plugin | ローカルのみ・コラボレーターと共有されない | ローカル設定ファイル | — |
| Plugin インストールスコープ: Managed | Plugin | 管理者が管理設定経由でインストール。ユーザーは変更不可 | 管理設定 | — |
アクセス制御設定合計: 20 行。
組織展開で最初に設定すべき 3 つの設定
組織で Claude Code を展開する場合、まず disableSkillShellExecution: true を管理設定に入れてください。ユーザーが !command`` 付きの Skill を作成してシェルを自由に実行する経路を遮断します。次に、Plugin のインストールを Managed スコープで中央管理することで、全員が同じバージョンの Plugin Skill を使う状態を維持できます。最後に、デプロイ系 Skill に disable-model-invocation: true を設定し、Claude が勝手に本番環境にデプロイしない状態を確保します。この 3 つを設定しておくと、自由度を保ちながら誤操作リスクを大幅に下げられます。
第 4 表: トラブルシュート — 症状・原因・対処一覧
Skill 運用で遭遇しやすいトラブルを 公式トラブルシューティングセクションと実運用から集約しました。
| 症状 | 原因 | 対処 | 参照 |
|---|---|---|---|
| Skill が期待どおりに自動起動しない | description にユーザーが自然に使うキーワードが不足している |
1. /skills で Skill がリストに表示されるか確認。2. description にトリガーフレーズを追加。3. リクエストの言い回しを変更。4. /<skill-name> で直接手動呼び出し |
公式 |
| Skill が頻繁すぎる場面で自動起動する | description が広すぎて無関係な会話でもマッチする |
description をより具体的な条件に絞り込む。副作用がある Skill は disable-model-invocation: true を設定 |
公式 |
| Skill の説明が短縮されてキーワードが効かない | スキル数が多いと description の文字予算が不足。description + when_to_use の組み合わせは 1,536 文字でカット |
主要ユースケースを description 冒頭に配置。SLASH_COMMAND_TOOL_CHAR_BUDGET 環境変数で上限引き上げも可能 |
公式 |
| 長セッションで Skill の動作が途中から止まる | 自動コンパクション(auto-compaction)後に古い Skill がドロップされた。25,000 トークンの再アタッチ予算を最近の Skill から埋めるため古い Skill が除外される | 該当 Skill をもう一度呼び出してフルコンテンツを復活させる。あるいはセッションを /clear で新規開始 |
公式 |
!command`` 動的注入が機能しない |
disableSkillShellExecution: true が設定されている |
管理設定で設定されている場合はユーザーが変更不可。自身の設定を確認し必要なら管理者に確認 | 公式 |
context: fork を設定したのにサブエージェントが空振りする |
リファレンス型 Skill(規約を書いているだけ)に context: fork を付けている。タスクなしの fork はガイドラインを受け取るだけで実行可能プロンプトがない |
context: fork はタスクとして実行する Skill のみに使用。リファレンス型はインライン(デフォルト)で実行させる |
公式 |
Plugin Skill が / メニューに表示されない |
Plugin インストール後に /reload-plugins を実行していない |
/reload-plugins を実行。それでも出ない場合は ~/.claude/plugins/cache を削除して Claude Code 再起動 |
公式 |
| Skill コンテンツが最初の応答後に動作に影響しなくなる | Skill コンテンツはセッション中 1 回だけメッセージとして入力される。後のターンで再読み込みはされない | タスク全体を通じて守ってほしいルールはスタンディング指示として書く(「常に〜する」の形式)。1 回限りの手順と区別して記述する | 公式 |
| 同名 Skill が複数スコープに存在して想定外の Skill が起動する | スコープ優先順位: Enterprise > Personal > Project。上位スコープが下位を上書き | /skills コマンドで現在アクティブな Skill と出処スコープを確認。意図しない Skill は上位スコープから削除 |
公式 |
| SKILL.md を保存したのに新しい Skill が認識されない | セッション開始前に存在しなかった最上位のスキルディレクトリを追加した場合、Claude Code はそのディレクトリを監視していない | Claude Code を再起動して新しいディレクトリを監視対象に追加させる。既存ディレクトリ内の変更はライブ反映される | 公式 |
トラブルシュート合計: 10 行。
Skill 全網羅表を使ったおすすめ導入ロードマップ
上の 4 つの表を踏まえて、導入フローを 4 段階で示します。各段階は独立しているため、今いるフェーズから始められます。
第 1 段階として、バンドル済み 7 種を 1 週間使い倒してください。インストール不要で、/simplify /debug /security-review を日常のコミット前後に差し込むだけで Claude が何をしているかが見えてきます。第 2 段階として、commit-commands Plugin を入れて /commit-commands:commit-push-pr を日常化します。git ワークフローの大半が 1 コマンドに集約され、繰り返し作業が削減されます。第 3 段階として、自社・自チームの規約を ~/.claude/skills/api-conventions/SKILL.md に書き出して Personal スコープで常駐させます。CLAUDE.md に長い規約を書くよりも、必要な場面でのみ読み込まれるため会話のコンテキスト負荷が下がります。第 4 段階として、disable-model-invocation: true のデプロイ系 Skill を作り、手動承認運用に組み込みます。allowed-tools: Bash(./deploy.sh) で事前承認ツールを限定し、Claude が自動実行できる範囲を明示します。
SKILL.md は 500 行以下・長いリファレンス資料は別ファイルに移動・description 冒頭に主要ユースケースを配置の 3 点が、公式が推奨する運用の核心です(出典: スキルで Claude を拡張する)。
出典(一次情報)
- スキルで Claude を拡張する — Claude Code 公式
- コマンドリファレンス — Claude Code 公式
- マーケットプレイスからプラグインを発見してインストールする — Claude Code 公式
- プラグインリファレンス — Claude Code 公式
- anthropics/claude-code plugins — GitHub
- Agent Skills オープン規格
- サブエージェント — Claude Code 公式
