example-skill

サンプルスキル

このスキルは、Claude Code プラグインスキルの構造と形式を示します。

概要

スキルは、タスクのコンテキストに基づいて Claude が自律的に使用する、モデルから呼び出される機能です。ユーザーが呼び出すコマンドや、Claude が起動するエージェントとは異なり、スキルは Claude が応答に取り入れるコンテキストに応じたガイダンスを提供します。

このスキルが適用される場面

このスキルは、ユーザーのリクエストに次の内容が含まれる場合に有効になります。

• プラグインスキルの作成や理解
• スキルのテンプレートやリファレンスの必要性
• スキル開発のパターン

スキルの構造

必須ファイル

skills/
└── skill-name/
    └── SKILL.md          # Main skill definition (required)

任意の補助ファイル

skills/
└── skill-name/
    ├── SKILL.md          # Main skill definition
    ├── README.md         # Additional documentation
    ├── references/       # Reference materials
    │   └── patterns.md
    ├── examples/         # Example files
    │   └── sample.md
    └── scripts/          # Helper scripts
        └── helper.sh

Frontmatter のオプション

スキルでは、次の frontmatter フィールドを使用できます。

• name（必須）：スキルの識別子
• description（必須）：起動条件。Claude がこのスキルを使用すべきタイミングを記述します
• version（任意）：セマンティックバージョン番号
• license（任意）：ライセンス情報または参照先

効果的な説明文の書き方

description フィールドは重要です。Claude にスキルをいつ呼び出すべきかを伝えます。

良い説明文のパターン：

description: This skill should be used when the user asks to "specific phrase", "another phrase", mentions "keyword", or discusses topic-area.

含める内容：

• ユーザーが使う可能性のある具体的な起動フレーズ
• 関連性を示すキーワード
• スキルが扱うトピック領域

スキルの内容に関するガイドライン

1. 目的を明確にする：スキルが何に役立つのかを示します
2. 使用するタイミングを示す：有効になる条件を定義します
3. ガイダンスを構造化する：情報を論理的に整理します
4. 実行可能な手順を示す：具体的なステップを提示します
5. 例を示す：役立つ場合は実践的な例を含めます

ベストプラクティス

• スキルの対象を単一の領域に絞ります
• 有効にするタイミングが明確に伝わる説明文を書きます
• 複雑なスキルでは、サブディレクトリにリファレンス資料を含めます
• 想定されるクエリでスキルが有効になることをテストします
• 他のスキルの起動条件と重複しないようにします