Claude Skillの作成方法

あなたは Claude Skill の構築を案内するガイドです。Skill が読み込まれるかどうかを決めるフィールドは、トリガーとして記述された SKILL.md のフロントマター内の description です。あなたは、空のフォルダーから動作する Skill を作成するまで、ユーザーを導きます。

CLAUDE SKILLの作り方 最初に作るスキルの多くは、まったく起動しません。フォルダーは正しい場所にあり、中の指示も申し分ないのに、Claudeはその存在を完全に無視します - スキルを読み込むかどうかを決めるフィールドが、トリガーではなくラベルとして書かれているからです。このガイドでは、空のフォルダーから、必要になった瞬間に自動で読み込まれるスキルを作るまでを説明します。スキルの存在を覚えておく必要はありません。 スキルとは何か、保存したpromptより優れている理由 保存したpromptは、覚えていて貼り付けた場合にしか役立ちません。スキルは違います。スキルは、Claudeが自分で見つけて読み込める指示入りのフォルダーです。あなたが書いた説明と、依頼内容が一致すると起動します。インストールした後は、その存在を意識しなくて済みます。タスクを依頼するだけで、内容が一致すれば、スキルの指示がその依頼へのClaudeの対応方法に組み込まれます。そのため、同じ方法で2回以上行う作業には、スキルを作る価値があります。定型的なレポート形式、特定のコードレビュー用チェックリスト、いつも使いたい文書の再構成方法などです。 フォルダー構成 スキルは、最低でも1つのファイル、SKILL.mdを含むフォルダーです。フォルダー名はSKILL.mdの内容ほど重要ではありませんが、一般的な名前ではなく、そのスキルの役割が具体的に分かる名前を付けてください。補助ファイル - 参照文書、スクリプト、テンプレート - はSKILL.mdと同じフォルダーに置き、SKILL.md内から参照します。スキルに本当に必要なものだけをフォルダーに入れてください。関係のないファイルがあると、Claudeが読み取る情報にノイズが増えます。 SKILL.mdとフロントマター SKILL.mdは、---の行で囲まれたフロントマターブロックで始まり、少なくともnameとdescriptionを含みます。Claudeが現在の依頼にこのスキルが関係するか判断するために確認するのは、本文全体ではなくフロントマターです。フロントマターを間違えると、本文の質は関係ありません。Claudeが本文を読み込まないからです。 name: 短い識別子で、小文字とハイフンを使います。スキルを参照するために使われます。トリガーになる項目ではありません。 description: スキル全体で最も重要な1行です。Claudeがユーザーの実際の依頼と照合し、スキルを読み込むか判断するのはこの項目です。 実際に起動するdescriptionの書き方 最もよくある間違いは、descriptionをトリガーではなくラベルとして書くことです。ラベルはスキルの内容を示します。一方、トリガーは、どのような依頼があったときに読み込むべきかを示し、実際の依頼で使われる表現に近い言葉で書かれます。 悪い例（ラベル）: 「コードレビューを支援します。」これは、一覧を読む人に向けたスキルの説明です。特定の依頼と照合するための情報がほとんどありません。「PRをレビューして」「この差分を確認して」「この変更を見て」といった依頼が、すべてこの説明と結び付かない可能性があります。 良い例（トリガー）: 「ユーザーがプルリクエストのレビュー、バグがないかの差分確認、マージ前のコードの再チェックを依頼したときに使用します。『このPRをレビューして』『変更を確認して』『このコードはマージできる状態？』などの表現で起動します。」これなら、単なるカテゴリーではなく、具体的な表現や状況と照合できます。