Codex にスキルを追加する方法

Codex(と、同じ skills オーサリングページ上の ChatGPT)は SKILL.md のあるフォルダを読み込みます。name と description は必須です。このページは Codex Build skills ドキュメントの場所だけを使います。

Codex Build skills から始める。

developers.openai.com/codex/skills を読んでください。スキルは SKILL.md と任意のスクリプト・参照があるディレクトリです。ChatGPT と Codex は、言及したとき、またはタスクが description に合うときにスキルを起動します。

Codex CLI または IDE 拡張では /skills を実行するか、$ でスキルを言及します。ChatGPT では @ でスキルを選びます。

Codex がローカルスキルを読み込む場所。

そのページから:

  • リポジトリ: 現在の作業ディレクトリからリポジトリルートまでの .agents/skills
  • ユーザー: $HOME/.agents/skills
  • 管理者: /etc/codex/skills

そのドキュメントは Codex の読み込みパスとして ~/.codex/skills フォルダを挙げていません。書かれているとおり .agents/skills(またはユーザーホームの .agents/skills)を使ってください。プラグインは1つのリポジトリを超えて再利用可能なスキルを配布します。$skill-installer はローカル用のキュレーション済みスキルを入れます。

Tiny Design Shop のスキルを追加する。

コンパニオン または GitHub からフォルダを入手し、リポジトリの .agents/skills/<pack>/ または $HOME/.agents/skills/ の下に置きます。Codex は変更を自動検出します。更新が出なければ Codex を再起動してください。

読み込まれたことを確認する。

/skills を実行するか、$ でスキルを言及します。削除せずに無効にするには、ドキュメントは ~/.codex/config.toml[[skills.config]]enabled = false とその SKILL.md へのパスを示しています。