Claude CodeとCodexのスキル:説明と起動の条件
Claude CodeやCodexのスキル(skills)は、繰り返す仕事の指示をまとめたものです。Agent Skillsの形式では、SKILL.mdの説明がアシスタントに「いつ使うか」を伝え、手順が「選ばれたあとに何をするか」を伝えます。作り方の例として、架空のサブスクリプションのAPI向けのレビューのスキルを考えます。変わったハンドラーを確かめ、繰り返されたリクエストをテストし、保存されたレコードが2回変わっていないかを報告する、という内容です。
スキルとリポジトリの指示の違い
リポジトリ全体の事実はAGENTS.mdの指示やCLAUDE.mdのガイダンスに書きます。レビューの手順は起動の条件がもっと狭いものです。関係のないタスクのたびに読み込むと、コンテキストを無駄にし、食い違う指示が入り込むこともあります。
ファイルと信頼
Claude CodeのスキルのガイドとCodexのスキルのガイド(英語)は、どちらもメタデータ、指示、任意のリソースを持つSKILL.mdのファイルを説明しています(2026年11月14日に確認)。どこから見つけるか、どう呼び出すかは製品ごとに違うので、スキルを入れる前に最新のガイドを確かめてください。
付属のスクリプトは、実行を許す前に読みます。環境変数のファイルをアップロードしたり、テストを無効にしたりするように求めるスキルは、説明がどれほど親切でも安全にはなりません。汚染されたスキルのケーススタディを練習し、起動の条件を、一致するリクエストだけでなく関係のないリクエストでもテストしてください。