# Skills ガイド Skills は Claude Code の知識レイヤーコンポーネントで、Claude に特定ドメインの専門知識とガイダンスを提供します。手動で呼び出す必要があるコマンドとは異なり、Skills はタスクのコンテキストに基づいて自動的にアクティブ化されます。 ## Skills とは？ Skills は `SKILL.md` ファイルに保存された専門知識モジュールです： - **自動アクティブ化**：Claude がタスクコンテキストに基づいて関連する Skill を自動的に使用 - **ドメイン知識**：特定ドメインのベストプラクティスとガイダンスを提供 - **拡張可能**：特定のニーズに合わせてカスタム Skills を作成可能 - **コンテキスト認識**：関連するシナリオでのみ呼び出される ### Skills vs Commands vs Agents | コンポーネント | トリガー | 目的 | |---------------|----------|------| | **Commands** | ユーザーが手動で呼び出し（`/command`） | 特定のタスクを実行 | | **Skills** | 自動アクティブ化 | ドメイン知識を提供 | | **Agents** | 委任呼び出し | 複雑なワークフローを処理 | ## ビルトイン Skills の使用 Claude Code プラグインには通常、複数のビルトイン Skills が含まれています。タスクが Skill の説明と一致すると、Claude は自動的にそれを使用します。 ### 例：コードレビュー 「このコードのセキュリティをレビューして」と言うと、セキュリティレビュー Skill を含むプラグインがインストールされている場合、Claude はその Skill の知識を自動的に適用してレビューを行います。 ### 利用可能な Skills の確認 Skills は通常、プラグインと一緒にインストールされます： ```bash # プラグインをインストール（プラグインには複数の Skills が含まれる場合があります） /plugin install plugin-name@marketplace ``` ## カスタム Skills の作成 ### 基本構造 最もシンプルな Skill には `SKILL.md` ファイルのみが必要です： ```bash my-skill/ └── SKILL.md ``` ### SKILL.md フォーマット ```markdown --- name: コードスタイルガイド description: ユーザーが「コードスタイル」「命名規則」「コードフォーマット」について質問したり、コーディング規約について議論したりする場合にこの Skill を使用 version: 1.0.0 --- # コードスタイルガイド ## 命名規則 - 変数は camelCase を使用 - 定数は UPPER_SNAKE_CASE を使用 - クラスは PascalCase を使用 - プライベートメンバーはアンダースコアプレフィックスを使用 ## フォーマットルール - インデントには 2 スペースを使用 - 行幅は 80 文字を超えない - 末尾カンマを使用 ## ベストプラクティス - 関数は単一責任であるべき - 深いネストを避ける - 意味のある変数名を使用 ``` ### Frontmatter フィールド | フィールド | 必須 | 説明 | |-----------|------|------| | `name` | はい | Skill 名 | | `description` | はい | トリガー条件の説明（重要！） | | `version` | いいえ | バージョン番号 | ### 効果的な Description の書き方 description フィールドは Skill がいつアクティブ化されるかを決定し、具体的なトリガーフレーズを含める必要があります： **良い例**： ```yaml description: ユーザーが「hook を作成」「PreToolUse hook を追加」「ツール使用を検証」と言ったり、hook イベントに言及した場合にこの Skill を使用 ``` **悪い例**： ```yaml description: hooks についてのガイド # 曖昧すぎる ``` ## 完全な Skill 構造 複雑な Skills には、より多くのリソースを含めることができます： ```bash my-skill/ ├── SKILL.md # メイン知識ドキュメント ├── references/ # 詳細なリファレンス │ ├── patterns.md # デザインパターン │ └── advanced.md # 高度なテクニック ├── examples/ # サンプルコード │ ├── basic.ts # 基本的な例 │ └── advanced.ts # 高度な例 └── scripts/ # ヘルパースクリプト └── validate.sh # 検証スクリプト ``` ### リソースの参照 SKILL.md で他のリソースを参照： ```markdown --- name: API 開発ガイド description: ユーザーが「API 設計」「REST インターフェース」「API ベストプラクティス」について質問した場合に使用 version: 1.0.0 --- # API 開発ガイド 詳細な API 設計パターンは @references/patterns.md を参照 ## クイック例 基本的な使い方は @examples/basic.ts を参照 ``` ## プラグインでの Skills 使用 ### ディレクトリ構造 Skills はプラグインの `skills/` ディレクトリに配置： ```bash my-plugin/ ├── .claude-plugin/ │ └── plugin.json ├── commands/ # コマンドレイヤー ├── agents/ # エージェントレイヤー └── skills/ # 知識レイヤー ├── code-style/ │ └── SKILL.md └── api-docs/ ├── SKILL.md └── references/ ``` ### コマンドでの Skill 参照 コマンドは Skill の知識を明示的に参照できます： ```markdown --- description: 規格準拠の API ドキュメントを生成 argument-hint: [api-file] --- @$1 の API ドキュメントを生成。 api-docs Skill を使用して、ドキュメントに以下が含まれることを確認： - 完全なエンドポイント説明 - パラメータ仕様 - レスポンス形式 - エラーコード - 使用例 ``` ## 実用的な例 ### 例 1：プロジェクト規約 Skill ```markdown --- name: プロジェクト規約 description: ユーザーが「プロジェクト構造」「ファイル構成」「ディレクトリ規約」について質問した場合に使用 version: 1.0.0 --- # プロジェクト規約 ## ディレクトリ構造 \`\`\` src/ ├── components/ # React コンポーネント ├── hooks/ # カスタム Hooks ├── services/ # API サービス ├── utils/ # ユーティリティ関数 └── types/ # TypeScript 型 \`\`\` ## ファイル命名 - コンポーネント：PascalCase（例：`UserProfile.tsx`） - ユーティリティ：camelCase（例：`formatDate.ts`） - 定数：UPPER_SNAKE_CASE（例：`API_ENDPOINTS.ts`） ## インポート順序 1. React 関連 2. サードパーティライブラリ 3. 内部モジュール 4. 型定義 5. スタイルファイル ``` ### 例 2：Git ワークフロー Skill ```markdown --- name: Git ワークフロー description: ユーザーが「ブランチ戦略」「コミット規約」「Git プロセス」について質問した場合に使用 version: 1.0.0 --- # Git ワークフロー規約 ## ブランチ命名 - 機能：`feature/説明` - 修正：`fix/説明` - 緊急修正：`hotfix/説明` ## コミットメッセージ形式 \`\`\` ():