Claude Code スキルシステム

概要

スキルはユーザーまたはClaudeが名前で呼び出せる再利用可能なプロンプトです。.claude/skills/ ディレクトリに SKILL.md ファイルとして定義します。プラグインからも提供されます。

ディレクトリ構造

.claude/skills/
  hello/
    SKILL.md         # スキル定義
  tdd-workflow/
    SKILL.md
  code-review/
    SKILL.md

各スキルは専用のディレクトリに SKILL.md を配置します。ファイル名は固定で、ディレクトリ名がスキル名になります。

Frontmatter

---
description: "TDDワークフローを実行するスキル"
disable-model-invocation: false
user-invocable: true
context: "fork"
agent: "Explore"
---

## TDDワークフロー

1. テストを先に書く（RED）
2. 最小限の実装を行う（GREEN）
3. リファクタリングする（IMPROVE）

フィールド	説明	デフォルト
description	スキルの説明	必須
disable-model-invocation	true でユーザーのみ呼び出し可能	false
user-invocable	false で / メニューに非表示	true
context	fork で独立サブエージェント環境で実行	メインコンテキスト
agent	context: fork 時のエージェントタイプ	デフォルト

コンテキストフォーク実行

context: fork を設定すると、スキルはメインの会話履歴にアクセスできない独立したサブエージェント環境で実行されます。リソース集約型や分離が必要な処理に適しています。

---
description: "大規模コードベースの検索"
context: "fork"
agent: "Explore"
---

プラグインスキル

プラグインは plugin.json の skills パスからスキルを提供します。プラグインディレクトリ構造の例：

plugin-name/
  .claude-plugin/
  plugin.json
  skills/
    hello/
      SKILL.md

カスタムエージェントでの活用

カスタムエージェント定義で skills フィールドを指定すると、エージェント起動時にスキルを自動ロードできます。

---
name: "tdd-agent"
description: "TDD専門エージェント"
skills: ["tdd-workflow", "verification-loop"]
model: "sonnet"
---

テスト駆動開発のベストプラクティスに従って実装を進めてください。

スキルの呼び出し

ユーザーは / メニューからスキルを選択するか、直接名前を入力して呼び出します。Claudeも状況に応じて自動的にスキルを呼び出します。

/hello
/tdd-workflow