AIエージェントのスキルを作る前に。手順と検証を分ける

手順をファイルにしても、検証まで自動にはならない。AIエージェントに繰り返し作業を任せるなら、何を渡し、何を返し、どこで人が確認するかを先に分けます。Claude Codeのスキルを使う場合も、便利な指示文を増やすことより、作業の契約を小さく書くことから始めます。

スキルは繰り返す手順を置く場所

同じ作業を毎回説明しているなら、入力から出力までの流れを一つの手順として残せます。ここでいうスキルは、AIが必ず正解する魔法の設定ではなく、繰り返す作業を同じ観点で始めるための文書です。繰り返す手順だけを切り出すと、作る価値があるかを判断しやすくなります。

たとえば、記事の下調べ、定型レポートの整形、変更点の確認は、毎回同じ順番で進めやすい作業です。一方で、前提が毎回大きく違う相談や、判断の責任を外へ渡す作業は、最初から一つのスキルに詰め込まない方が扱いやすいでしょう。

スキルの本文を書く前に、作業の入口と出口を決めます。次の項目は、Anthropicがすべてのスキルへ要求する必須項目という意味ではなく、このサイトで使う作業契約の型です。

項目が埋まらないときは、スキルの実装を急がず、質問を残します。入力が曖昧なのに出力だけを整えると、見た目のよい誤りが繰り返されるためです。

作業契約は、短い本文から始めて構いません。最初の一回で全ケースを説明するのではなく、実際に迷った条件を一つずつ追記し、対象外の依頼を受けたときの返し方も残します。

スキルには作業の順番を書き、検証には期待する結果を書きます。たとえば、三つのサンプルを用意し、必ず残る項目、変換される項目、エラーになる項目を一つずつ含めます。成功例だけで検証しないことが、手順の修正点を見つける近道です。

検証結果は、入力、期待値、実際の出力、差分、次の修正という五つの欄で残します。うまくいったかどうかだけでなく、どの条件で失敗したかを記録すれば、スキルの対象範囲を狭める判断もできます。

ファイルを読む作業と、ファイルを変更する作業と、メールや購入を実行する作業は、同じ成功条件では測れません。読む・変更する・確定するを分けるため、最初のスキルは読み取りや下書きまでに留め、外部操作は別の承認段階へ置きます。

権限と承認の切り分けについては、外部操作AIの範囲と承認を整理した記事でも扱っています。スキルが再利用できることと、外部へ実行してよいことは別の判断です。

最後に、作業をスキルへ切り出す前に確認します。月に何度も同じ順番で発生するか、入力形式がある程度そろっているか、出力の合否を人が確認できるか、失敗時に元へ戻せるか。この四つへ答えられない場合は、まずチェックリストや短いメモで運用します。

手順が安定したら、Claude Codeのスキルとして保存する方法を検討します。自分用の道具を試すときの利用者・データ・変更範囲の決め方は、Claude Codeで個人用ツールを試す前の確認にもつながります。

2026年8月30日に、Anthropic公式ドキュメント：Claude Codeのスラッシュコマンドとスキルを確認しました。スキルのファイル配置や再利用の説明を、この記事の作業契約と照合しています。

公式の仕様や配置方法は変わることがあります。実際に設定するときは、現在の公式案内を確認し、検証結果を残してから対象範囲を広げてください。