Codex のスキル。
Codex のスキルは、SKILL.md ファイルを含むフォルダで、CI の修正やデザインのレビューなど、ある種類の作業のやり方を Codex に教えるものです。このガイドでは、スキルの置き場所、インストールと呼び出しの方法、Codex が適切なタイミングで選んでくれるスキルの書き方、最初に入れたいスキルを解説します。
2026年11月12日 更新 · 約 7 分で読めます
結論から
- スキルはフォルダです。
SKILL.mdファイルにname、description、Markdown で書いた指示を入れます。スクリプトや参考ファイルも入れられます。 - インストールは、Codex で
$skill-installerにスキル名か GitHub の URL を渡すか、フォルダを~/.agents/skillsにコピーします。そのあと Codex を再起動してください。 - 使うには、
/skillsを実行するか、$に続けてスキル名を入力します。リクエストがスキルの description に合えば、Codex が自分で選ぶこともあります。 - 自作するには、組み込みの
$skill-creatorを使います。Codex が使うかどうかは description で決まるので、時間をかけるのはここです。 - OpenAI の
openai/skillsカタログは非推奨になりました。 今後の公式スキルは、openai/pluginsリポジトリのプラグインに含まれて配布されます。
Codex のスキルとは
スキルは、1 つの作業に必要な指示を、必要ならスクリプトや素材と一緒にまとめたものです。Codex はセッションの開始時に、各スキルの name と description だけを読みます。タスクが description に合ったとき、またはスキルを指定したときに、SKILL.md の全文を読み込みます。だから、何十個ものスキルを入れていても、コンテキストウィンドウを圧迫しません。
スキルはオープンな Agent Skills 形式に従っています。そのため、SKILL.md を読むほかのエージェント(Claude Code を含む)でも、たいてい同じフォルダが使えます。プラグインは別のものです。複数のスキルに加えて MCP サーバーやフックも含められる、インストール用のパッケージです。違いは Codex のプラグインとスキルの違いで解説しています。
Codex のスキルの置き場所
| 範囲 | パス | 向いている用途 |
|---|---|---|
| リポジトリ | 作業中のフォルダから、リポジトリのルートまでにある .agents/skills | 1 つのプロジェクトに属するスキル |
| ユーザー | ~/.agents/skills | すべてのプロジェクトで使いたいスキル |
| 組織 | /etc/codex/skills | 管理者が全員のためにインストールするスキル |
| システム | Codex に同梱 | skill-creator、skill-installer など |
Codex は、起動した場所からリポジトリのルートまでの .agents/skills フォルダをすべて確認します。同じ名前のスキルが 2 つあっても統合されず、両方が一覧に表示されます。スキルフォルダのシンボリックリンクも使えるので、スキルを 1 つの Git リポジトリで管理している人に便利です。
スキルの使い方
- 選ぶ: Codex CLI や IDE 拡張機能で
/skillsを実行し、スキルを選びます。 - 指定する: プロンプトに
$とスキル名を入力します。例:$gh-fix-ci the build on this branch is red - Codex に任せる: ふだんどおりタスクを伝えます。スキルの description に合えば、Codex が自分でそのスキルを読み込みます。
ChatGPT デスクトップアプリでは、$ の代わりに @ を入力します。
Codex のスキルをインストールする方法
$skill-installer を使う
$skill-installer は Codex に同梱されているシステムスキルです。名前か GitHub のフォルダを渡します。
$skill-installer gh-address-comments
$skill-installer install https://github.com/ummydev/pretty-ui/tree/main/skills/pretty-ui
名前だけを渡すと、OpenAI が選んだカタログからインストールされます。URL を渡すと、公開されているリポジトリならどこからでもインストールできます。新しいスキルが表示されない場合は、Codex を再起動してください。
フォルダをコピーする
スキルはただのファイルなので、フォルダを ~/.agents/skills(すべてのプロジェクト)か .agents/skills(1 つのプロジェクト)にクローンまたはコピーしても使えます。チームで共有するいちばん簡単な方法は、リポジトリにコミットすることです。Codex でそのプロジェクトを開いた人全員が、そのスキルを使えるようになります。
プラグインから入れる
OpenAI は openai/skills リポジトリを非推奨とし、自社のスキルを openai/plugins リポジトリのプラグインに含めて配布するようになりました。Figma、Notion、Linear、GitHub、Vercel、Build Web Apps、Product Design などがあります。Codex CLI で /plugins を実行すると、一覧を見てインストールできます。プラグインなら、スキルと必要なツールを 1 ステップでインストールできます。
自分のスキルを書く方法
いちばん早いのは、Codex に頼むことです。
$skill-creator ユーザー単位のスキル design-review を作成してください。UI の画面をプロジェクトの DESIGN.md と照らし合わせて確認します。色とフォントは DESIGN.md に書かれたものだけを使う、余白は 8px グリッド、本文は 16px 以上、アイコンに絵文字を使わない、というルールです。問題はファイル名と行番号つきの一覧で報告し、そのあと修正してください。
自分でファイルを書く場合は、~/.agents/skills/design-review/SKILL.md に作ります。
---
name: design-review
description: Review a UI screen against the project's DESIGN.md. Use when the user asks for a design review, says a screen looks off, or before finishing any UI change.
---
1. Read DESIGN.md. If there is none, say so and stop.
2. Check colors, fonts, spacing, and type sizes against it.
3. List each problem with the file and line, then fix it.
Codex に使われるスキルと無視されるスキルの差は、次の 3 点で決まります。
- description は、選ばれるように書く。 スキルが何をするのか、いつ使うのかを、人が実際に入力する言葉で書きます。「Use when the user asks for a design review」は効きますが、「Design helper」では効きません。
- SKILL.md は短く保つ。 長い参考資料は
references/フォルダに置き、いつ読むかをスキルに書いておきます。Codex は必要なときだけ追加のファイルを読み込みます。 - 決まった手順はスクリプトにする。 チェックや変換のように、毎回同じやり方で実行したい処理は
scripts/に置き、スキルから実行させます。
Codex が自分でスキルを使わないようにしつつ、$name での呼び出しは使えるようにしたい場合は、スキルのフォルダに agents/openai.yaml を追加して、policy: { allow_implicit_invocation: false } を指定します。
入れておきたい Codex のスキル
| スキル | できること | 入手方法 |
|---|---|---|
skill-creator、skill-installer | スキルの作成とインストール | 組み込み |
imagegen | Codex の中でプロンプトから画像を生成する | 組み込み |
gh-fix-ci | 失敗した GitHub Actions のログを読み、ビルドを直す | $skill-installer gh-fix-ci |
gh-address-comments | 開いているプルリクエストのレビューコメントに順に対応する | $skill-installer gh-address-comments |
playwright | 実際のブラウザを操作し、Codex が作ったものをテストしてスクリーンショットを撮る | $skill-installer playwright |
security-best-practices | よくあるセキュリティ上のミスがないかコードをレビューする | $skill-installer security-best-practices |
| Figma スキル | Figma のフレームをコードに、コードを Figma に変換する | Figma プラグイン(/plugins から) |
| Taste Skill | UI を、ありがちな AI っぽい見た目から遠ざける | チュートリアルを参照 |
| pretty-ui | AI 特有のデザインのクセを見つけて直す | $skill-installer install https://github.com/ummydev/pretty-ui/tree/main/skills/pretty-ui |
デザイン用途に絞った比較は、UI デザインにおすすめの Codex スキルと Taste Skill、Impeccable、UI UX Pro Max の比較で紹介しています。
スキルを無効にする方法と、表示されないときの対処
スキルを削除せずに無効にするには、~/.codex/config.toml に次を追加して Codex を再起動します。
[[skills.config]]
path = "/Users/you/.agents/skills/design-review/SKILL.md"
enabled = false
path の代わりに name = "design-review" を指定すると、その名前のスキルをすべて無効にできます。
/skills にスキルが表示されないときは、次を確認してください。
- Codex を再起動する。 新しいスキルは、セッションの開始時に読み込まれます。
- フォルダを確認する。 ファイル名は
SKILL.mdで、上記のいずれかのパスにあるスキルのフォルダ直下に置く必要があります。 - frontmatter を確認する。
nameとdescriptionはどちらも必須です。 - スキルが多すぎないか確認する。 起動時のスキル一覧に使われるのは、コンテキストウィンドウの約 2% です。それを超えると、Codex は description を短くしたり、スキルを一覧から外したりし、警告を表示します。
config.tomlのskills.max_context_tokensで上限を引き上げるか、使わないスキルを削除してください。
よくある質問
Claude Code のスキルは Codex でも使えますか?
たいてい使えます。どちらも SKILL.md 形式を使っています。~/.claude/skills のフォルダを ~/.agents/skills にコピーしてください。どちらか一方にしかないツールを使うよう指示しているスキルは、書き直す必要があります。
スキルと AGENTS.md の違いは何ですか?
AGENTS.md は、そのプロジェクトのすべてのセッションで読み込まれるので、常に守ってほしいルールに向いています。スキルは、タスクが必要としたときだけ読み込まれるので、ときどき使うワークフローに向いています。スクリプトや参考ファイルも持たせられます。
Codex のスキルはどこで探せますか?
/plugins にある OpenAI のプラグイン、非推奨ですがまだ読める openai/skills リポジトリ、作者が GitHub で公開しているスキルです。インストールする前に、スキルのファイル、とくにスクリプトの中身を読んでください。スキルは Codex と同じ権限で動きます。