Skills (スキル)

Claude は関係する場面でスキルを使い、ユーザーが /skill-name の形で直接呼び出すこともできます。CLAUDE.md の内容と異なり、スキルの本文は使われるときだけ読み込まれるため、長い参考資料も必要になるまではほとんどコストがかかりません。Claude Code のスキルは、複数の AI ツールで使える Agent Skills のオープン標準に沿っています。

カスタムコマンドはスキルに統合されており、.claude/commands/deploy.md のファイルと .claude/skills/deploy/SKILL.md のスキルは、どちらも /deploy を作り、同じように動きます。

スキルのディレクトリには複数のファイルを置けます。SKILL.md には要点だけを書き、詳しい参考資料は Claude が必要なときだけ参照します。また、スキルには任意の言語のスクリプトを同梱して実行させることができます。

スキルを保存する場所によって、どのセッションで読み込まれるかが決まります。

• プロジェクトのスキルは、Claude Code を起動したディレクトリと、そこからリポジトリのルートまでの各親ディレクトリにある .claude/skills/ から読み込まれます。
• ネストした .claude/skills ディレクトリのスキルは、そこにあるファイルで作業するときに読み込まれ、名前が衝突した場合は <dir>:<name> として表示されます。
• ~/.claude/skills/、プロジェクトの .claude/skills/、--add-dir で指定したディレクトリ内の .claude/skills/ でスキルを追加・編集・削除すると、bare mode を除き、再起動せずに現在のセッションへ反映されます。
• /reload-skills で、セッションを再起動せずにスキルディレクトリを再スキャンできます。

• 引数と置換: スキルの呼び出し時に引数を渡せ、本文では $ARGUMENTS で受け取ります。本文には動的な値の文字列置換も使えます。
• 動的なコンテキスト: ` !<command> ` の構文は、スキルの内容が Claude に送られる前にシェルコマンドを実行し、その出力で置き換えます。
• ツールの事前許可: allowed-tools に挙げたツールは、スキルを呼び出したターンの間、承認の確認なしに使えます。
• ツールの除外: frontmatter の disallowed-tools で、スキルが有効な間、モデルからツールを外せます。
• サブエージェントでの実行: context: fork を付けると、agent フィールドで指定した種類の新しいサブエージェントで、スキルの内容をプロンプトとして分離して実行します。このスキルは既定でバックグラウンド実行となり、background: false でスキルごとに無効にできます。
• 複数スキルの重ね掛け: ターミナルのプロンプトでは、1 つのメッセージの先頭に複数のスキルを並べられ、先頭のスキルを最大 5 個まで読み込みます。

同梱スキルはプロンプトベースで、関係する場面で Claude が自動で呼び出すものと、/verify のようにユーザーが呼び出したときだけ動くものがあります。

• **/run と /verify**: 設定なしで動き、プロジェクトの種類と README・package.json・Makefile の内容から起動方法を推定します。
• **/run-skill-generator**: クリーンな環境からアプリを起動し、うまくいった手順を .claude/skills/run-<name>/ にプロジェクト単位のスキルとしてコミットします。
• **/claude-api**: プロジェクトの言語に合わせて Claude API と Managed Agents の参考資料を読み込みます。コードが anthropic または @anthropic-ai/sdk を import していると自動で有効になります。既定で Claude Opus 5 を使い、Opus 4.8 からの移行手順を含みます。
• **/dataviz**: チャートやダッシュボードのデザインガイダンスと、実行可能なカラーパレット検証ツールを備えます。
• **/skill-doctor**: 各スキルのコストと使用頻度を表示し、オフにするスキルを判断する材料になります。
• **/less-permission-prompts**: トランスクリプトから読み取り専用の Bash や MCP ツール呼び出しを探し、.claude/settings.json 向けの許可リストを提案します。

claude.ai アカウントでサインインしたセッション、Cowork、クラウドセッションでは、claude.ai アカウントで有効にしたスキルを設定なしで読み込みます。同期されたスキルは /skills のメニューで claude.ai sync の下に表示されます。

同期されたスキルはローカルのコマンドや MCP プロンプトを上書きせず、説明はサニタイズされてラベルが付きます。手元のマシンでは、本文の ! コマンドや @ ファイル展開は実行されません。クラウドセッションでは anthropic-skills:<name> の名前になり、ほかに同じ名前が使われていなければ元の名前でも呼び出せます。

• /permissions の deny ルールに Skill を加えると、すべてのスキルを無効にできます。
• skillOverrides 設定で、frontmatter ではなく設定側からスキルの表示を制御できます。off はモデルと / の両方から隠し、user-invocable-only はモデルからだけ隠し、name-only は説明を折りたたみます。/skills メニューでスキルを選んで Space で状態を切り替え、Esc で .claude/settings.local.json に保存します。
• disableSkillShellExecution 設定で、スキル・カスタムスラッシュコマンド・プラグインコマンド内のインラインシェル実行を無効にできます。
• disableBundledSkills 設定または CLAUDE_CODE_DISABLE_BUNDLED_SKILLS 環境変数で、同梱スキル・ワークフロー・組み込みスラッシュコマンドをモデルから隠せます。
• claude.ai アカウントからターミナルセッションへの同期は、syncClaudeAiSkills: false または syncClaudeAiPlugins: false で止められます。
• OpenTelemetry の claude_code.skill_activated イベントは、ユーザーが入力したスラッシュコマンドでも発火し、invocation_trigger 属性 (user-slash・claude-proactive・nested-skill) を持ちます。
• 1 つのソース (リポジトリ、個人のフォルダ、プラグイン) のスキルが登録できるフックは、セッションあたり最大 1,024 個・マッチャー 16,384 文字です。

1. 個人用のスキルフォルダに、スキル用のディレクトリを作ります。個人用スキルはすべてのプロジェクトで使えます。
2. SKILL.md を書きます。--- で囲んだ YAML frontmatter に Claude がスキルを使う場面を書き、続く Markdown に、スキルの実行時に Claude が従う指示を書きます。
3. git プロジェクトを開いて任意のファイルを少し編集し、claude を実行して Claude Code を起動します。
4. スキルの説明に合う内容を依頼して Claude に自動で呼び出させるか、/skill-name の形で直接呼び出して動作を確かめます。