Skill をテストして配布する
skill を反復改良し、チームと共有する
⏱ 想定 ~6 分
01 · 読む
skill を書くのは仕事の半分にすぎません。残り半分はテストと反復改良です。
紙の上では正しく見えた skill が、実際に使ってみると一貫しない出力を生むことがあります。Claude が 5 つあるルールのうち 4 つだけ守って 1 つ落とすかもしれません。曖昧な指示の解釈があなたの意図とずれるかもしれません。
テストのループはシンプルです。skill を有効化する、それを発動させるタスクを Claude に与える、出力がルールに従っているかチェックする、ずれていれば skill を直す。
コードと同じで、skill も反復で良くなります。ほとんどの skill は安定して動くまでに 2〜3 回の磨きが必要です。
ポイントまとめ
- /skill で有効化し、関連するタスクを Claude に与えて skill をテストする
- skill 本体のルール 1 つ 1 つに照らして出力をチェックする
- エッジケースもテストする—想定外の入力ではどうなる？
- 反復する: ほとんどの skill は 2〜3 回の磨きが必要
- skill は git でバージョン管理する—単なるファイルだから
02 · ステップ解説
skill を作るときも更新するときも、毎回このフローに従いましょう。
1. skill を作るか更新する
SKILL.md ファイルを書くか変更します。.claude/skills/your-skill/SKILL.md に保存してください。更新の場合は、1 度に 1 箇所ずつ変更すると、効果を確認しやすくなります。
2. /skill で有効化する
Claude Code の会話で /skill と打ち、一覧から自分の skill を選びます。これで Claude は指示を読み込み、残りの会話でずっとそれに従います。
3. Claude に関連するタスクを与える
あなたの skill のルールが発動するような仕事を Claude に頼みます。コードレビューの skill ならコードのレビューを、コミットメッセージの skill ならコミットを頼みます。おもちゃの例ではなく、実際の入力で試しましょう。
4. 出力をチェックする
出力は skill のルール 1 つ 1 つに従っていますか？箇条書き、書式要件、制約をひとつずつ確認してください。徹底的にチェックしましょう—部分的にしか合っていないなら、skill には改良の余地があります。
5. 改良して繰り返す
問題があれば skill 本体を更新します。Claude がずれた箇所はより明確に書き直す。正しい出力の例を追加する。曖昧な表現を消す。そして同じタスクでもう一度テストします。
6. git にコミットする
複数のテストケースで skill が安定して動くようになったら、コミットしましょう。Skill はファイルです—ほかのものと同じようにバージョン管理に属します。git add .claude/skills/ && git commit -m 'feat: add code-reviewer skill'
03 · 読む
skill が安定して動くようになったら、置き場所を決めます。第 1 課で学んだとおり、2 つの場所があります:プロジェクト skill(.claude/skills/)は git にコミットしてチームと共有でき、ユーザー skill(~/.claude/skills/)は個人用であなたのすべてのプロジェクトに適用されます。
ルールはシンプルです。チームの慣習ならプロジェクト skill としてコミットする。個人の好みならユーザー skill としてローカルに置いておく。
ポイントまとめ
- プロジェクト skill:git にコミット → チーム全員が恩恵を受ける
- ユーザー skill:ローカルに残す → 個人の好みだけ
- プロジェクト skill はほかのコード変更と同じようにコミットする
04 · クイズ
チームのコミットメッセージ形式を強制する skill を作りました: コミットは 'feat:' や 'fix:' のような type プレフィックスで始めるというものです。これはプロジェクト skill にすべき？それともユーザー skill にすべき？
- プロジェクト skill—チームの慣習であり、git にコミットされる
- ユーザー skill—~/.claude/skills/ に置いて個人で使う
- どちらでもよい
- skill ではなく、設定ファイルにすべき
05 · 空欄補充
~/.claude/skills/ に置く skill は _____ skill と呼ばれます。あなたのすべてのプロジェクトを横断して付いてくるからです。
⚠ 全機能のインタラクティブ体験には JavaScript が必要です。JavaScript を有効にして再読み込みしてください。
※ このサイトは独立した教育プロジェクトで、Anthropic の公式製品ではありません。Claude™ は Anthropic, PBC の商標です。