フィールドガイド / 15 分
繰り返す workflow を Skills にする
Focused SKILL.md で authoring、distribution/connectors が必要なら plugin。
Skills は instructions、references、scripts、assets を package し、Codex は選択時だけ full instructions を読みます。Plugins は configured marketplace 経由で skills と optional MCP を配布します。Install 前に marketplace を list/review し、明示的な plugin を選びます。
検証済みターミナル手順
- ›
$skill-creator - ›
/skills - ›
$skill-name - $
codex plugin marketplace list - $
codex plugin marketplace add owner/repo --ref main - $
codex plugin list - $
codex plugin add <PLUGIN>@<MARKETPLACE>
作業原則
One skill, one job
Precise description が explicit/implicit trigger を改善。
Progressive disclosure
Metadata 常駐、full body は必要時。
Distribution separate
Local authoring 後、team install/connectors なら plugin。
Marketplace は trust decision
Local config/cache に追加する前に Git/local source と available plugins を review。
フィールド手順
- 01
Trigger 定義
Should/should-not を先に書く。
- 02
Creator
$skill-creator 後 SKILL.md を review。
- 03
Helpers narrow
Deterministic need がある時だけ scripts。
- 04
Trigger test
$skill-name と positive/negative prompts。
- 05
Distribution 選択
Repo は .agents/skills、stable shared は plugin。
- 06
Install path を検証
Marketplaces/plugins を list、explicit selector を add、capability を確認し lab 後に remove。
PASS / FAIL
受入チェック
- Scope/trigger clear。
- I/O/verification explicit。
- Scripts 最小 authority。
- Marketplace origin/plugin selector reviewed。
- Plugin に real need。
WATCH / REJECT
失敗パターン
- Giant universal skill。
- New custom prompt workflow。
- 不要 scripts。
- 名前だけで unreviewed marketplace から install。