CodexのSkillsを使う

毎回同じ確認手順を説明しているなら、Skillsにまとめる方法があります。Skillは、特定の仕事で使う手順や参考資料を一組にしたものです。ここでは「短い文章の見直し」だけを扱う小さな例で、使う場面・指示・確認方法を整理します。

以下は公式仕様を参照した説明用ひな形です。実際の環境での検出・呼び出し・結果の成功は別途確認が必要です。最初から外部サービスや実行スクリプトを追加する必要はありません。

AGENTS.mdとSkillの使い分け

例えば「公開前に出典を確認する」はブログ用AGENTS.mdの共通ルールに、「文章の未定事項を残して見直す手順」はSkillに分けられます。同じ指示を両方へ大量に複製すると、後から内容がずれやすくなります。

各段階で確認してから、次の操作へ進みます。

1. 1用途一つの作業に絞る
2. 2説明使う場面と対象外を書く
3. 3手順確認方法までまとめる
4. 4試す適用と対象外の両方を確かめる

具体的な依頼と、結果の確かめ方は本文にあります。

Skillは名前と説明から使う場面を判断され、選ばれると詳しい手順が読まれます。置くだけで毎回実行される定期処理ではありません。

一つの作業に絞って作る

公式の作成支援を使う場合、Codexで $skill-creator を指定し、用途を説明できます。例：

$skill-creator
短い日本語のメモを見直すSkillを作りたいです。
日付・数値・固有名詞・未定事項を残し、読みやすさの修正案を示す用途です。
翻訳や事実調査には使いません。最初は説明だけのSkillにし、外部通信やスクリプトは加えないでください。

生成案を確認するときは、読みやすさのために未定事項を確定へ変えていないかを見る手順が含まれるかを確かめます。

SKILL.mdの小さな例

手動で作る場合は、作業リポジトリの .agents/skills/memo-review/SKILL.md という構成にします。SKILL.md.txt にならないように注意してください。既存の同名Skillがある場合は、内容を調べてから統合か別名を選びます。

---
name: memo-review
description: 短い日本語メモの表現を見直すときに使う。翻訳や新規の事実調査には使わない。
---

1. ユーザーが指定したメモだけを読む。対象がなければ確認する。
2. 日付・数値・固有名詞・未定事項を先に一覧にする。
3. それらを変えずに、読みやすい修正案を示す。
4. 不明な内容を推測で補わない。未定は未定のまま残す。
5. 元の文と修正案を比べ、変えた表現を説明する。
6. ファイルへの保存はユーザーが依頼したときだけ行う。

名前とdescriptionは必須です。説明には、何をするときに使い、何には使わないかを書きます。公式資料ではリポジトリ内とユーザー共通の読み込み場所が分かれているので、最初は一つの練習プロジェクトに限定すると影響範囲を追いやすくなります。

呼び出して、適用結果を確かめる

CLI・IDE拡張では /skills や $ による指定が案内されています。memo-reviewが見つかるか確認し、次のように依頼します。

$memo-review
「公開日は未定。見出し案は9月18日まで。担当は青木さん。」を見直してください。
ファイルには保存せず、残した事実と修正案を示してください。

公開日が9月18日に変わっていたら失敗です。9月18日は見出し案の期限であり、公開日は未定のままです。さらに「英語に翻訳して」という対象外の依頼で、意図せずこのSkillが適用されないかも確かめます。

検出されない場合は、フォルダーの位置・ファイル名・nameとdescriptionを確認します。公式には変更の自動検出が案内されていますが、反映されないときはCodexを再起動して確認します。名前が同じでも内容が自動で統合されるわけではありません。

指示を増やす前に確認すること

元の意味が保てるまでは、長い手順や外部スクリプトを追加せず、失敗した一例から直します。Skillは作業権限を拡大したり、システムの承認をなくしたりする仕組みではありません。必要な権限は作業範囲の案内で確認してください。

実際の文章整理例は意味を残して文章を整える、共通ルールはAGENTS.mdへ続きます。

公式資料：Build skills。このメモ用ひな形と確認課題は独自の説明用例です。

初めて開く人への使い方の案内は、実装に合わせたREADMEへ残せます。

特定のタイミングで処理を呼び出したい場合は、Hooksの役割と確認順を検討できます。