Agent Skills は、description が会話の文脈と一致すれば、エージェントが自分の判断で読み込み、そこに書かれた手順や方針に従って動く。
文脈に合ったスキルが黙って出てくるのは、たいていの場合は便利である。
ただし、以前のカスタムスラッシュコマンドがそうだったように、人間が明示的に呼んだときだけ動いてほしいスキルもある。

Skills への統合で、モデルが自分から発火できるようになった

Claude Code のカスタムスラッシュコマンドは Skills に統合された。
例えば　.claude/commands/deploy.md と .claude/skills/deploy/SKILL.md はどちらも CLI上で /deploy コマンドを作り、同じように動く。
既存の .claude/commands/ はそのまま動き続けるが、AnthropicはSkillsを推奨しているため、これから書くなら Skills 側に寄せることになる。

Codex も同じ方向に進んでいる。
~/.codex/prompts/ に置くカスタムプロンプトは非推奨になり、公式ドキュメントは skills への移行を案内している。

Skills は、description が会話の文脈に一致すればモデル自身が読み込んで実行する。
これが便利なスキルもあるが、そうでないスキルもある。

困るのは次のようなスキルである。

実装フロー最後のチェック：テスト一式、レビュー、セキュリティ検査。数分から数十分と、それなりのトークンを消費する
開発環境の後片付け：コンテナやボリュームの削除、作業ブランチの整理、一時ファイルの掃除。取り消せない操作が混ざる
デプロイや外部への送信：実行した時点で外に出る

いずれも「作業が一段落した」という文脈で発火しやすい。
そしてまさにその文脈は、モデルが気を利かせたくなる場面でもある。
コードが完成したように見えるからといって、モデルの判断でデプロイが走ってはたまらない。

Claude Code にバンドルされている /verify と /code-review は、Claude Codeのバージョンアップで、ユーザーが呼んだときだけ動く仕様に変更された。
時間とトークンを食う検査をいつ走らせるか、その判断をSkillsの人間の側に戻した形になる。

Skills の発火制御はツールごと

SKILL.md の書式（name と description を持つ frontmatter と、本文の自然言語）は Agent Skills というオープン標準に基づいている。
共通なのはここまでで、例えば置き場所だったり、今回主題の発火制御はツールごとに違う。

	Claude Code	Codex
プロジェクト	`.claude/skills/<name>/SKILL.md`	`.agents/skills/<name>/SKILL.md`
個人	`~/.claude/skills/<name>/SKILL.md`	`~/.agents/skills/<name>/SKILL.md`
明示発火	`/skill-name`	`$skill-name`、または `/skills`
暗黙発火の禁止	frontmatter の `disable-model-invocation`	`agents/openai.yaml` の `policy`

Claude Code での明示発火

frontmatter に一行足すだけでよい。

---
name: deploy
description: Deploy the application to production
disable-model-invocation: true
---

Deploy $ARGUMENTS to production:

1. Run the test suite
2. Build the application
3. Push to the deployment target
4. Verify the deployment succeeded

これで /deploy と打ったときだけ動き、Claude が自分の判断で読み込むことはなくなる。

副次的な効果として、コンテキストの消費も減る。
通常のスキルは、本文こそ発火時にしか読み込まれないものの、description は「どんなスキルが使えるか」の一覧として常にコンテキストに載っている。
disable-model-invocation: true を付けると、モデルに選ばせる必要がなくなるため、description も載らなくなる。

発火の主体と読み込みのタイミングは、三通りに整理できる。

frontmatter	ユーザーが呼べる	モデルが呼べる	コンテキストへの読み込み
（既定）	Yes	Yes	`description` は常時、本文は発火時
`disable-model-invocation: true`	Yes	No	`description` も載らない。本文は発火時
`user-invocable: false`	No	Yes	`description` は常時、本文は発火時

逆向きの user-invocable: false は、/ メニューから隠してモデル専用にする指定である。

disable-model-invocation は、スケジュール実行やサブエージェントへのプリロードも同時に止める。
モデル側の経路をまとめて塞ぐ指定だと考えるとよい。

Codex での明示発火

Codex は frontmatter ではなく、スキルディレクトリの中の agents/openai.yaml で制御する。

.agents/skills/cleanup-devenv/
├── SKILL.md
└── agents/
    └── openai.yaml

# agents/openai.yaml
policy:
  allow_implicit_invocation: false

allow_implicit_invocation の既定値は true で、false にするとユーザーのプロンプトに基づく暗黙の発火だけが止まる。
$skill-name による明示発火はそのまま使える。
Claude Code の disable-model-invocation: true と役割が対応する。

Codexの場合、明示発火の書き方は二つある。
入力欄で $ に続けてスキル名を打つか、/skills でセレクタを開いて選ぶ。

agents/openai.yaml には、display_name や short_description といった表示用の項目も置ける。

参考