最初のスキルを作成する
最初のスキルを作成する · 4分
この動画では、スキルをゼロから構築する手順を説明します——すべてのプロジェクトで使える、個人用のPR説明スキルです。SKILL.mdファイルの構造の作り方、テストの方法、そしてClaude Codeがどのようにスキルを発見しリクエストに照合するかを正確に確認できます。この動画では、名前が競合したときにどのスキルが優先されるかを決める優先順位階層についても扱います。
重要なポイント
- スキルとは、フロントマターにメタデータ(name、description)を持ち、その下に指示が続く
SKILL.mdファイルを含むディレクトリです - Claudeは起動時にスキル名と説明のみを読み込み、その後、受信したリクエストをセマンティックマッチングを使ってそれらの説明と照合します
- マッチした場合、name、description、instructionsのみを持つスキルは確認を求めることなく完全に読み込まれます。スキルがツールを事前承認したりフックを追加したりする場合、Claude Codeは先に承認を求めることがあります
- 名前の競合に対する優先順位:Enterprise → Personal → Project。プラグインのスキルは名前空間で区切られているため、同じ名前のスキルと並行して読み込まれます
- スキルを更新するには、その
SKILL.mdを編集します。削除するには、そのディレクトリを削除します。Claude Codeは再起動なしで現在のセッション内で変更を反映します。このセッションで~/.claude/skillsが新規に作成された場合は、変更のたびに/reload-skillsを実行してください
スキルをゼロから作成する手順を一通り見た後、Claude Codeが実際に裏側でどのようにスキルを読み込み、照合しているかを見ていきましょう。
スキルの作成
ここでは、一貫したフォーマットでPRの説明を書く方法をClaudeに教える個人用スキルを構築します。これは個人用スキルなので、ホームディレクトリに置かれ、すべてのプロジェクトで機能します。
まず、skillsフォルダ内にスキル用のディレクトリを作成します。ディレクトリ名はスキル名と一致させる必要があります。
mkdir -p ~/.claude/skills/pr-description次に、そのディレクトリ内にSKILL.mdファイルを作成します。このファイルはフロントマターのダッシュで区切られた2つの部分から構成されます。
---
name: pr-description
description: Writes pull request descriptions. Use when creating a PR, writing a PR, or when the user asks to summarize changes for a pull request.
---
When writing a PR description:
1. Run `git diff main...HEAD` to see all changes on this branch
2. Write a description following this format:
## What
One sentence explaining what this PR does.
## Why
Brief context on why this change is needed
## Changes
- Bullet points of specific changes made
- Group related changes together
- Mention any files deleted or renamednameはスキルを識別します。descriptionはClaudeにいつそれを使うべきかを伝えます——これがマッチングの基準です。2組目のダッシュの後のすべては、スキルが有効化されたときにClaudeが従う指示です。

スキルのテスト
Claude Codeはスキルディレクトリを監視しているため、新しいスキルは再起動なしで現在のセッション内で利用可能になります。セッション開始時に~/.claude/skillsが存在しなかった場合、Claude Codeはまだそれを監視していないため、今すぐ/reload-skillsを実行し、その後の変更のたびにも再度実行してください。利用可能なスキルの一覧を確認することで、スキルが利用可能になっていることを確認できます。

スキルが一覧に表示されているはずです。テストするには、ブランチ上で何か変更を加えて、「自分の変更に対するPRの説明を書いて」のように伝えてみてください。Claudeはpr-descriptionスキルを使用していることを示し、差分を確認し、テンプレートに沿った説明を書きます——毎回同じフォーマットです。
スキルのマッチングの仕組み
Claude Codeが起動すると、いくつかの場所をスキルについてスキャンしますが、読み込むのはnameとdescriptionのみで、完全な内容ではありません。これは重要な点です。
リクエストを送信すると、Claudeはあなたのメッセージを利用可能なすべてのスキルのdescriptionと比較します。例えば、「この関数が何をするか説明して」というリクエストは、「視覚的な図でコードを説明する」と記述されたスキルと、意図が重なるためマッチします。
マッチが見つかると、Claudeは完全なSKILL.mdファイルを読み込み、その指示に従います。name、description、instructionsのみを持つスキル(pr-descriptionのような)は、確認を求めることなく読み込まれます。スキルがツールを事前承認したりフックを追加したりする場合、権限モードによっては、Claude Codeが先に承認を求めることがあります。上の動画と下の画像は、Claude Code v2.1.19がpr-descriptionのようなスキルについて削除した承認ステップを示しています。

スキルの優先順位
自分の個人用スキルの1つと同じ名前のスキルを持つリポジトリをクローンした場合、どちらが優先されるのでしょうか?明確な優先順位があります。
- Enterprise — 管理設定、最も優先度が高い
- Personal — ホームディレクトリ(
~/.claude/skills) - Project — リポジトリ内の
.claude/skillsディレクトリ
これにより、組織はエンタープライズスキルを通じて標準を強制しつつ、個人によるカスタマイズも引き続き可能にできます。あなたの会社にエンタープライズの「code-review」スキルがあり、あなたが同じ名前の個人用「code-review」スキルを作成した場合、エンタープライズ版が優先されます。インストール済みプラグインのスキルは、この順序の外にあります。これらは/plugin-name:skill-nameとして名前空間で区切られているため、プラグインのスキルと同じ名前の別のスキルの両方が読み込まれます。
競合を避けるには、わかりやすい名前を使用してください。単に「review」とするのではなく、「frontend-review」や「backend-review」のような名前を使いましょう。
スキルの更新と削除
スキルを更新するには、そのSKILL.mdファイルを編集します。削除するには、そのディレクトリを削除します。Claude Codeは現在のセッション内で変更を反映するため、再起動する必要はありません。このセッションの早い段階で~/.claude/skillsが新規だったために/reload-skillsを実行した場合は、変更のたびに再度実行してください。
レッスンの振り返り
- 日々のワークフローの中で、今すぐスキルに変えられるタスクは何でしょうか?そのdescriptionはどのようなものになるでしょうか?
- 優先順位階層は、チームのスキル管理戦略にどのような影響を与える可能性があるでしょうか?個人用スキルとプロジェクトレベルのスキルのどちらをより重視しますか?
次のステップ
次のレッスンでは、メタデータフィールド、allowed-toolsによるツールの事前承認、段階的開示と複数ファイル構成を使ったより大きなスキルの構造化方法など、高度な設定オプションについて学びます。