codexで安装skillするならここだけ読めばOK！迷わず入れる手順と落とし穴まとめ
「codex 安装skill」と検索している人の多くは、Codexにスキルを追加したいけれど、どこに置けばいいのか、どう呼び出すのか、ChatGPTやClaudeのSkillsと何が違うのかが曖昧な状態だと思います。そこでこの記事では、OpenAI公式のCodex Skillsドキュメント、openai/skillsリポジトリ、ChatGPT Skillsのヘルプ、VS CodeのAgent Skills解説などをもとに、初めてでも迷いにくい形で整理しました。
結論からいうと、CodexのSkillは「便利な拡張機能」というより、Codexに特定作業の進め方を覚えさせるための作業手順フォルダです。SKILL.mdを中心に、必要ならscripts/やreferences/を添えて、毎回同じ説明をしなくてもCodexが適切な流れで作業しやすくする仕組みです。
| この記事のポイント |
|---|
| ✅ CodexでSkillを安装する基本手順がわかる |
✅ SKILL.mdの役割と保存場所がわかる |
✅ $skill-installerと$skill-creatorの使い分けがわかる |
| ✅ Claude・ChatGPT・VS CodeのSkillsとの違いが整理できる |
codexで安装skillする前の基礎知識
- codex 安装skillの答えは「$skill-installerで入れる」か「SKILL.mdフォルダを置く」こと
- codexとはどんな本ですか？への答えはAI開発ツールのCodexと本のcodexを分けること
- Skillはプロンプトではなく再利用できる作業手順であること
- CodexがSkillを使う流れは説明文で判断して必要時だけ読むこと
- Skillの保存場所は用途ごとにrepo・user・adminで分けること
- ChatGPTやClaudeのSkillsとCodex Skillsは同じ発想でも導入方法が違うこと
codex 安装skillの答えは「$skill-installerで入れる」か「SKILL.mdフォルダを置く」こと
「codex 安装skill」と検索した人がまず知りたい答えは、かなりシンプルです。CodexでSkillを使う方法は大きく分けて、既存Skillをインストールする方法と、自分でSkillフォルダを作る方法の2つです。
OpenAI公式ドキュメントでは、既存の curated skills をローカルに追加する場合、$skill-installerを使う方法が案内されています。たとえば、openai/skillsのGitHubリポジトリにも、curatedまたはexperimentalなSkillを$skill-installerで入れる説明があります。
“To add curated skills beyond the built-ins for your own local Codex setup, use $skill-installer.”
引用元：https://developers.openai.com/codex/skills
ただし、すべてのSkillを必ず$skill-installerで入れる必要があるわけではありません。自作Skillの場合は、SKILL.mdを含むフォルダを、Codexが読める場所に置くことで利用できます。一般的には、ユーザー個人用なら~/.codex/skills、リポジトリ専用なら.agents/skillsが候補になります。
📌 Codex Skillの安装方法まとめ
| 方法 | 向いている人 | 主な使い方 |
|---|---|---|
$skill-installerを使う |
既存Skillをすぐ使いたい人 | curated skill名やGitHub URLを指定する |
| 手動でSkillフォルダを置く | 自作・社内用Skillを作りたい人 | SKILL.md入りフォルダを所定場所へ置く |
| pluginとして配布する | 複数人・チームに配りたい人 | Skillをpluginにまとめる |
ここで大事なのは、Skillは「アプリを追加する」というより、Codexが作業するときに参照する手順書を追加するという理解です。ブラウザ拡張のようにボタンが増えるイメージだけで考えると、少しズレます。
また、Skillを追加したのにCodex上で見えない場合は、公式情報ではCodexの再起動が案内されています。Skillの変更は自動検出される場合がありますが、反映されないときは再起動が現実的な確認手段です。
✅ 最初に試す順番
| 順番 | やること |
|---|---|
| 1 | $skill-installerで使いたいSkill名を指定する |
| 2 | 追加後にCodexを再起動する |
| 3 | /skillsや$入力で候補に出るか確認する |
| 4 | 出ない場合は保存場所とSKILL.mdの形式を確認する |
codexとはどんな本ですか？への答えはAI開発ツールのCodexと本のcodexを分けること
関連検索に「codexとはどんな本ですか？」が出てくるのは、少しややこしいポイントです。英語の“codex”には、もともと「写本」「古文書」「冊子状の本」といった意味があります。そのため、検索結果では本や古文書の話と、OpenAIのCodexの話が混ざることがあります。
一方、この記事で扱うCodexは、OpenAIが提供する開発作業を支援するAIエージェント環境のCodexです。コード作成、リポジトリ調査、CLI、IDE拡張、アプリ上での作業などを支援する文脈で使われています。
つまり、「codex 安装skill」と検索している場合のcodexは、一般的な本の意味ではなく、OpenAI CodexにSkillを追加する話だと考えるのが自然です。ただし、検索語に中国語の「安装」が混ざっているため、おそらく「install skill」「スキルをインストール」と同じ意図で検索している可能性があります。
📚 codexという言葉の意味の切り分け
| 検索語 | 意味として近いもの | この記事で扱うか |
|---|---|---|
| codexとはどんな本ですか？ | 写本・古文書・冊子 | 補足のみ |
| OpenAI Codex | AI開発支援ツール | 扱う |
| codex 安装skill | CodexにSkillを入れる方法 | メインで扱う |
| Codex Skills | Codex用の再利用ワークフロー | メインで扱う |
検索時に混乱しやすいのは、Codexという単語自体が固有名詞でも一般名詞でもあるからです。AI関連の情報を探す場合は、「OpenAI Codex Skills」「Codex skill-installer」「Codex SKILL.md」などの語を足すと、目的に近い情報に寄せやすくなります。
🔍 検索意図別の見方
| 知りたいこと | 見るべき情報 |
|---|---|
| Codexとは何か | OpenAI Codexの概要 |
| Skillを入れたい | Codex Skills公式ドキュメント |
| Skillを作りたい | $skill-creatorやSKILL.md仕様 |
| 既存Skillを探したい | openai/skills GitHubリポジトリ |
この切り分けができると、検索結果のノイズが減ります。とくに日本語・英語・中国語が混ざった検索では、単語の意味が広がりやすいため、目的語を少し足すだけで探しやすくなります。
Skillはプロンプトではなく再利用できる作業手順であること
CodexのSkillを理解するうえで大事なのは、Skillを「長いプロンプト」とだけ考えないことです。もちろん、Skillの中心にはSKILL.mdというMarkdownファイルがあり、そこにはCodexへの指示が書かれます。しかし本質は、毎回同じ作業説明をしなくても、Codexが必要な手順を読み込めるようにする仕組みです。
OpenAI公式ドキュメントでは、Skillは「instructions, resources, optional scripts」をまとめるものとして説明されています。つまり、単なる文章だけでなく、スクリプト、参考資料、テンプレートなども含められます。
“A skill packages instructions, resources, and optional scripts so Codex can follow a workflow reliably.”
引用元：https://developers.openai.com/codex/skills
たとえば、毎回「GitHub PRのレビューコメントを読み、未対応コメントを整理し、必要なら修正して」と頼む場合、その流れをSkill化できます。そうすると、次回からはCodexが該当Skillを見つけて、同じような手順で進めやすくなります。
🧩 Skillと通常プロンプトの違い
| 比較項目 | 通常プロンプト | Skill |
|---|---|---|
| 使い方 | 毎回入力する | 必要時にCodexが読み込む |
| 再利用性 | 低め | 高め |
| 含められるもの | 主に文章 | 指示・スクリプト・資料・テンプレート |
| 向いている用途 | その場限りの依頼 | 繰り返す業務手順 |
| 管理場所 | チャット内 | Skillフォルダ |
Skillのメリットは、作業の一貫性です。人間側が毎回細かく説明しなくても、Codexが「この作業ならこのSkillが合いそう」と判断できるため、抜け漏れを減らしやすくなります。
✅ Skill化に向いている作業
| 作業例 | Skill化の相性 |
|---|---|
| PRレビュー対応 | 高い |
| 特定形式の記事作成 | 高い |
| 毎回同じ検証手順 | 高い |
| 一度だけの雑談 | 低い |
| 毎回条件が大きく変わる相談 | やや低い |
注意したいのは、Skillを増やせば増やすほど便利になるとは限らない点です。説明文が曖昧なSkillが大量にあると、Codexがどれを使うべきか迷う可能性があります。Skillは「多ければ強い」ではなく、使いどころが明確なものを少数精鋭で置くほうが扱いやすいです。
CodexがSkillを使う流れは説明文で判断して必要時だけ読むこと
Codex Skillsの特徴として、最初から全Skillの本文を丸ごと読むわけではない点があります。公式ドキュメントでは、CodexはまずSkillの名前・説明・パスを見て、必要そうなSkillだけSKILL.md本文を読む仕組みだと説明されています。
この仕組みは「progressive disclosure」と呼ばれています。日本語にすると「段階的に必要な情報だけ開く」ような考え方です。大量のSkillを全部読み込むと会話の文脈を圧迫するため、まず短い説明だけを見て、必要になったときに詳しい手順を読む設計です。
“Skills use progressive disclosure to manage context efficiently.”
引用元：https://developers.openai.com/codex/skills
ここで重要になるのが、SKILL.mdのfrontmatterにあるdescriptionです。Codexはこの説明文を見て、Skillを使うかどうか判断します。つまり、説明文が弱いと、せっかくSkillを作っても呼ばれにくくなる可能性があります。
🧠 CodexがSkillを読む流れ
| 段階 | Codexが見るもの | 目的 |
|---|---|---|
| 1 | Skill名 | 候補をざっくり把握する |
| 2 | description | 使うべきか判断する |
| 3 | SKILL.md本文 | 具体的な手順を読む |
| 4 | scripts/references/assets | 必要に応じて追加情報を使う |
このため、Skill作成では本文より先にdescriptionを丁寧に書くことが大事です。本文に「このSkillはこういう時に使う」と書いても、Codexが本文を読む前に候補から外してしまえば意味が薄くなります。
✅ 良いdescriptionの条件
| 条件 | 例 |
|---|---|
| 何をするSkillか明確 | “Create and update Codex skills…” |
| いつ使うか明確 | “Use when the user asks to create a new skill…” |
| 範囲が広すぎない | “all AI tasks”のような曖昧表現を避ける |
| 重要語が前半にある | 説明が短縮されても伝わる |
Skillがうまく起動しないときは、まずdescriptionを見直すのが近道です。「便利なSkillなのに呼ばれない」場合、原因は中身の品質ではなく、Codexが見つけにくい説明文にあるかもしれません。
Skillの保存場所は用途ごとにrepo・user・adminで分けること
Codex Skillは、保存場所によってスコープが変わります。公式ドキュメントでは、repository、user、admin、systemといった場所が紹介されています。ざっくりいうと、特定リポジトリだけで使うのか、自分の環境全体で使うのか、管理者が配るのかで置き場所を分けます。
リポジトリ専用なら.agents/skillsに置く方法があります。チームで同じリポジトリを触る場合、そのリポジトリに必要なSkillを一緒に管理できるため、作業手順を共有しやすくなります。
個人用なら$HOME/.agents/skillsや、CodexのローカルSkill保存先が候補になります。提供情報では、WindowsではC:\Users\<ユーザー名>\.codex\skills\のような場所が紹介されていました。ただし環境によって差があるため、実際のCodex設定も確認したほうがよいです。
📂 Codex Skillの主な保存場所
| スコープ | 保存場所の例 | 向いている用途 |
|---|---|---|
| REPO | .agents/skills |
リポジトリ専用の作業手順 |
| USER | ~/.agents/skillsや~/.codex/skills |
個人でどのプロジェクトでも使うSkill |
| ADMIN | /etc/codex/skills |
管理者が配る共通Skill |
| SYSTEM | Codexに同梱 | OpenAI側が提供する基本Skill |
保存場所を間違えると、Skillが見えない、または想定外のプロジェクトで出てくることがあります。たとえば、ある社内リポジトリ専用の手順をユーザー全体に置くと、別プロジェクトでも候補に出て混乱するかもしれません。
🧭 保存場所の選び方
| 状況 | おすすめ |
|---|---|
| そのリポジトリだけで使う | repo配下の.agents/skills |
| 自分だけが全作業で使う | user配下のskills |
| 組織全体で配布する | adminまたはplugin |
| 公開配布したい | plugin化を検討 |
Skillはシンボリックリンクにも対応していると公式情報にあります。つまり、実体を別場所に置きつつ、Codexが読む場所からリンクさせる運用もできます。ただし初心者は、まず通常のフォルダ配置で動作確認するほうが安全です。
ChatGPTやClaudeのSkillsとCodex Skillsは同じ発想でも導入方法が違うこと
Skillsという考え方は、Codexだけのものではありません。OpenAI Help Centerの情報では、ChatGPTにもSkillsがあり、Business、Enterprise、Edu、Teachers、Healthcareプランなどでベータ提供されていると説明されています。また、ChatGPTのSkillsはCodexやAPIでもサポートされるが、製品間ではまだ同期しないとされています。
つまり、ChatGPTで作ったSkillがそのままCodexに自動反映されるわけではない、という点に注意が必要です。ただし、OpenAIのSkillsはAgent Skills open standardに沿っているため、ダウンロードして別製品にインストールする考え方はあります。
“While they don’t sync across products yet, OpenAI skills follow the Agent Skills open standard.”
引用元：https://help.openai.com/en/articles/20001066-skills-in-chatgpt
Claude系のSkillsや、VS CodeのAgent Skillsも似た概念を持っています。Medium記事では、ClaudeからCodexへ考え方を移す場合、CodexではSKILL.mdを中心に、scripts/、references/、assets/を整理する発想が紹介されていました。
🔄 各サービスのSkillsの違い
| 項目 | Codex | ChatGPT | Claude系・VS Code系 |
|---|---|---|---|
| 主な用途 | 開発・作業自動化 | 会話内の再利用ワークフロー | エージェント作業支援 |
| 管理単位 | Skillフォルダ・plugin | ChatGPTのSkills画面 | 各ツールのSkill管理 |
| 中心ファイル | SKILL.md |
UI上のSkill管理 | SKILL.md系が多い |
| 自動同期 | 製品間では基本なし | Codexと自動同期はしない | ツールごとに異なる |
ここで混同しやすいのは、「同じSkillsという名前だから全部同じ手順で使える」と考えてしまうことです。実際には、思想は近くても、インストール方法、保存場所、呼び出し方法はツールごとに違います。
✅ 乗り換え時の確認ポイント
| 確認項目 | 見るべき点 |
|---|---|
| Skillの形式 | SKILL.mdがあるか |
| 保存先 | Codexが読む場所に置いたか |
| スクリプト | WindowsやMacで動くか |
| 説明文 | Codexが自動判断できる内容か |
| 反映 | 再起動後に候補へ出るか |
ClaudeやChatGPTで便利だった作業手順をCodexに移す場合は、まず「その手順をSKILL.mdに短く書く」「長い資料はreferences/に分ける」「繰り返す処理はscripts/に置く」という順番で考えると整理しやすいです。
codexで安装skillを失敗しない実践手順
- 既存Skillを入れるなら$skill-installerで名前かGitHub URLを指定すること
- 自作Skillを作るなら$skill-creatorでSKILL.mdの骨組みを作ること
- AI回答を見る前に公式情報とopenai/skillsを確認すること
- SKILL.mdはnameとdescriptionを必ず正しく書くこと
- Skillが動かない原因は保存場所・名前・再起動漏れにあること
- FigmaやVS CodeのAgent SkillsはMCPやエディタ連携と分けて考えること
- 総括：codex 安装skillのまとめ
既存Skillを入れるなら$skill-installerで名前かGitHub URLを指定すること
既存Skillを使いたい場合、いちばんわかりやすい入口は$skill-installerです。OpenAI公式ドキュメントとopenai/skillsリポジトリのどちらでも、curated skillやexperimental skillのインストールに$skill-installerが案内されています。
たとえば、openai/skillsの説明では、curated skillは名前でインストールでき、experimental skillはフォルダやGitHub URLを指定して入れられるとされています。つまり、Skill名がわかっているなら名前指定、場所がわかっているならURL指定が基本です。
“Curated skills can be installed by name.”
引用元：https://github.com/openai/skills
実際のイメージとしては、$skill-installer gh-address-commentsのようにSkill名を指定します。GitHub上の特定フォルダから入れたい場合は、https://github.com/openai/skills/tree/main/...のようなURLを渡す形です。
🛠 インストール指定方法の違い
| 指定方法 | 例 | 向いている場面 |
|---|---|---|
| Skill名 | $skill-installer linear |
curated skillを入れたい |
| GitHubフォルダURL | $skill-installer install https://github.com/... |
experimentalや外部Skillを入れたい |
| repo + path | openai/skills + skills/.experimental/... |
パスを明確に指定したい |
インストール後は、Codexを再起動するのが無難です。openai/skillsのREADMEにも、Skillをインストールした後にCodexを再起動して新しいSkillを拾わせる説明があります。
✅ インストール後チェックリスト
| チェック | 内容 |
|---|---|
| Skillフォルダが作られたか | ~/.codex/skillsなどを確認 |
SKILL.mdがあるか |
必須ファイル |
| 名前が正しいか | フォルダ名とnameの整合 |
| Codexを再起動したか | 反映漏れ対策 |
| Skill候補に出るか | /skillsや$で確認 |
注意点として、ネットワーク経由でGitHubから取得する場合、環境によっては認証や権限で失敗することがあります。Private repositoryのSkillを入れる場合は、既存のGit認証やトークンが必要になるかもしれません。このあたりは環境依存があるため、エラー文を見て判断するのが現実的です。
自作Skillを作るなら$skill-creatorでSKILL.mdの骨組みを作ること
自分用、チーム用、案件用にSkillを作るなら、最初から手書きしてもよいですが、まず$skill-creatorを使うのがわかりやすいです。OpenAI公式ドキュメントでも、Skill作成ではbuilt-in creatorを使う方法が案内されています。
$skill-creatorは、どんなSkillにするか、いつ使うか、スクリプトを含めるか、説明だけにするかといった点を整理しながらSkillを作るための支援機能です。いきなり完璧なSKILL.mdを書くより、作業内容を整理しながら形にできます。
“Use the built-in creator first: $skill-creator.”
引用元：https://developers.openai.com/codex/skills
自作Skillの最小構成は、Skill名のフォルダと、その中のSKILL.mdです。SKILL.mdにはYAML frontmatterとしてnameとdescriptionが必要です。本文には、Codexに実行してほしい作業手順を書きます。
📄 最小構成の例
| ファイル・フォルダ | 必須か | 役割 |
|---|---|---|
my-skill/ |
必須 | Skill本体のフォルダ |
SKILL.md |
必須 | メタ情報と手順を書く |
scripts/ |
任意 | 実行用スクリプト |
references/ |
任意 | 詳細資料 |
assets/ |
任意 | テンプレートや素材 |
初心者がやりがちな失敗は、SKILL.mdに全部を詰め込みすぎることです。長い仕様書、巨大な例、細かい業務ルールをすべて本文に入れると、読む側のCodexにとって重くなります。詳細資料はreferences/に分け、本文には「必要なときにこのファイルを見る」と書くほうが扱いやすいです。
✅ 自作Skill作成の基本ステップ
| 順番 | 内容 |
|---|---|
| 1 | どんな依頼で起動するSkillか決める |
| 2 | Skill名を小文字ハイフン形式にする |
| 3 | $skill-creatorで骨組みを作る |
| 4 | descriptionを具体的に書く |
| 5 | 手順を短く整理する |
| 6 | 必要な資料だけreferences/へ分ける |
| 7 | Codexで呼び出して動作確認する |
自作Skillは、最初から大きく作らないほうがよいです。まずは「毎回同じ説明をしている作業」1つだけをSkill化し、実際に使いながら足りない部分を改善していくほうが現実的です。
AI回答を見る前に公式情報とopenai/skillsを確認すること
関連検索に「codex 安装skill AI回答を見る」があるように、検索結果のAI要約だけで済ませたい人も多いはずです。ざっくり把握するにはAI回答も便利ですが、Skillは実際にローカル環境へ入れるものなので、最終的には公式情報を確認したほうが安全です。
とくにSkillは、フォルダ内にスクリプトを含めることができます。便利な一方で、外部から取ってきたSkillを無確認で実行すると、意図しないコマンドやファイル操作が含まれている可能性もあります。これは脅す話ではなく、Skillを「コード依存物の一種」として見るべきという話です。
VS CodeのAgent Skills解説でも、共有Skillを使う際には要件やセキュリティに合うか確認するよう促されています。Codexでも同じ発想で、外部Skillは中身を見てから使うのが無難です。
🔎 確認すべき一次情報
| 情報源 | 何を確認するか |
|---|---|
| OpenAI Codex Skills公式 | 保存場所、作成方法、無効化方法 |
| openai/skills GitHub | curated/experimental Skillの実例 |
| ChatGPT Help Center | ChatGPT側のSkills仕様 |
| VS Code Agent Skills | open standardとしての仕様感 |
| Figma MCP Help | Figma連携時のSkillsの考え方 |
AI回答は便利ですが、2026年5月26日時点でも、CodexやSkills周辺は更新が入りやすい領域です。とくに保存場所、対応クライアント、管理画面、インストール方法は変わるかもしれません。そのため、記事やAI回答で方向性をつかみ、実行前に公式ドキュメントを見る流れがよいです。
✅ AI回答を使うときの見方
| 使い方 | 注意点 |
|---|---|
| 概要把握 | 便利 |
| コマンドのコピー | 公式と照合したい |
| 外部Skillの導入 | 中身を確認したい |
| エラー解決 | エラー文ベースで判断したい |
とくに「安装」という語で検索している場合、中国語圏の記事や個人ブログが混ざる可能性があります。参考になる情報もありますが、Codex本体の仕様はOpenAI公式とGitHubリポジトリを軸に確認するのが安全です。
SKILL.mdはnameとdescriptionを必ず正しく書くこと
SKILL.mdで最も重要なのは、frontmatterのnameとdescriptionです。Codex公式ドキュメントでは、この2つが必須として説明されています。本文がどれだけ丁寧でも、frontmatterが壊れているとSkillとして認識されない可能性があります。
nameはSkillの識別名です。一般的には小文字、数字、ハイフンを使った短い名前が扱いやすいです。VS CodeのAgent Skills解説では、名前にスラッシュ、コロン、ドット、namespace prefixなどを入れると読み込みに失敗する可能性があると説明されています。
descriptionは、CodexがそのSkillを使うか判断するための説明文です。「便利なSkillです」では弱く、「何をするときに使うか」を具体的に書く必要があります。たとえば「Use when asked to install Codex skills from curated sources or GitHub repo paths」のように、使う場面が明確な説明が向いています。
🧾 SKILL.mdの基本形
| 要素 | 必須 | 書く内容 |
|---|---|---|
name |
必須 | Skillの識別名 |
description |
必須 | 何をするSkillか、いつ使うか |
| 本文 | 必須 | Codexが従う手順 |
| scripts参照 | 任意 | 必要な実行手順 |
| references参照 | 任意 | 詳細資料への案内 |
最小の例は次のような形です。
---
name: my-skill
description: Use when Codex needs to follow a repeatable workflow for a specific task.
---
# Workflow
1. Confirm the user's target.
2. Read the relevant files.
3. Execute the defined steps.
4. Report the result clearly.
✅ descriptionを書くときのコツ
| 悪い例 | 改善例 |
|---|---|
| “Helpful skill.” | “Use when asked to install Codex skills from curated or GitHub sources.” |
| “For coding.” | “Use when debugging failing GitHub Actions workflows.” |
| “Article support.” | “Use when drafting SEO blog articles from provided research text.” |
| “General assistant.” | 範囲が広すぎるためSkill化しないほうがよい |
descriptionは検索キーワードのような役割も持ちます。Codexが「この依頼にはこのSkillが合いそう」と判断できるよう、作業名、対象ツール、典型的な依頼文を前半に入れるのが実用的です。
Skillが動かない原因は保存場所・名前・再起動漏れにあること
Skillを安装したのに動かない場合、まず疑うべきは複雑なバグではなく、基本的な読み込み条件です。多くの場合、保存場所、SKILL.mdの有無、frontmatterの形式、Codex再起動漏れあたりに原因があります。
たとえば、Skillフォルダを作ったつもりでも、実際にはmy-skill/SKILL.mdではなくmy-skill/docs/SKILL.mdのように深い場所へ置いていると、Codexが期待通りに拾わない可能性があります。フォルダ名とnameの整合も確認したほうがよいです。
openai/skillsのREADMEでは、インストール後にCodexを再起動して新しいSkillを拾うよう案内されています。Skill変更が自動検出される場合もありますが、反映されないときは再起動が簡単な切り分けになります。
🧯 よくある原因と対処
| 症状 | ありそうな原因 | 対処 |
|---|---|---|
| Skill候補に出ない | 保存場所が違う | Codexが読むskillsフォルダを確認 |
| Skillとして読まれない | SKILL.mdがない |
ファイル名を確認 |
| 自動起動しない | descriptionが曖昧 | 使う場面を明記 |
| インストール後に出ない | 再起動していない | Codexを再起動 |
| エラーが出る | YAML形式ミス | frontmatterを確認 |
また、Skillを無効化したい場合は、~/.codex/config.tomlに[[skills.config]]を追加し、対象Skillのenabled = falseを指定する方法が公式ドキュメントで紹介されています。削除せず一時停止したい場合に便利です。
⚙️ 無効化設定の考え方
| 操作 | 向いている場面 |
|---|---|
| Skill削除 | もう使わない |
enabled = false |
一時的に止めたい |
| description修正 | 誤起動を減らしたい |
| 保存場所変更 | スコープを限定したい |
Skillが動かないときに、いきなり中身を大きく書き換えるのはおすすめしません。まずは「Codexが認識できているか」「手動呼び出しできるか」「descriptionで自動判断できるか」の順で切り分けると、原因を見つけやすくなります。
FigmaやVS CodeのAgent SkillsはMCPやエディタ連携と分けて考えること
FigmaのMCP server解説にもSkillsの話が出てきます。Figmaでは、MCP serverがFigmaのデザイン情報をAIエージェントに渡し、Skillsが「どのツールをどう順番に使うか」を助けるものとして説明されています。
ここで重要なのは、SkillはMCP接続そのものではないという点です。Figmaヘルプでも、SkillsはMCP機能を置き換えたり新しいMCP能力を追加したりするものではなく、推奨ワークフローを再利用可能な指示としてまとめるものだと説明されています。
“Skills don’t replace MCP connections or add new MCP capabilities.”
引用元：https://help.figma.com/hc/en-us/articles/32132100833559-Guide-to-the-Figma-MCP-server
VS CodeのAgent Skillsも、Codex Skillsとかなり近い考え方です。VS Codeでは.github/skills/、.claude/skills/、.agents/skills/などのプロジェクトSkillや、~/.copilot/skills/などの個人Skillが説明されています。Agent Skills open standardに沿った形で、複数のAIツールで使える方向性が見えます。
🧩 Skill・MCP・エディタ連携の違い
| 用語 | 役割 |
|---|---|
| Skill | AIに作業手順を教える |
| MCP | 外部ツールやデータへ接続する仕組み |
| Plugin | SkillやMCP設定などを配布する単位 |
| IDE拡張 | エディタ上でAIを使うための環境 |
Figmaのような外部ツール連携では、MCP serverをつなぐだけでは作業品質が安定しないことがあります。そこでSkillが「デザインコンポーネントをどう読むか」「コードにどう落とすか」「どの順で確認するか」を補助します。
✅ Figma連携での理解
| やりたいこと | 必要なもの |
|---|---|
| Figmaデザイン情報を取る | Figma MCP server |
| 取得した情報をどう実装するか決める | Skill |
| Codexで作業する | Codex本体 |
| チームで同じ流れを使う | Skillやpluginの共有 |
つまり、codexで安装skillする目的がFigmaやVS Code連携にある場合でも、「接続」と「手順」は分けて考えると理解しやすいです。MCPは道具への橋、Skillはその道具を使う作業マニュアルに近いものです。
総括：codex 安装skillのまとめ
最後に記事のポイントをまとめます。
- codex 安装skillの基本は、既存Skillなら
$skill-installer、自作SkillならSKILL.mdフォルダである。 - CodexのSkillは、単なる長文プロンプトではなく、再利用できる作業手順である。
- Skillの最小構成は、Skillフォルダと
SKILL.mdである。 SKILL.mdにはnameとdescriptionが必須である。- Codexはdescriptionを見てSkillを使うか判断するため、説明文が重要である。
- curated skillは名前指定、experimental skillや外部SkillはGitHub URL指定で入れられる場合がある。
- Skillをインストールした後に反映されない場合は、Codex再起動を確認する。
- Skillが動かない原因は、保存場所、ファイル名、YAML形式、descriptionの曖昧さにあることが多い。
- ChatGPT、Claude、VS CodeにもSkillsの考え方はあるが、導入方法や保存場所は同じではない。
- OpenAI SkillsはAgent Skills open standardに沿うが、製品間で自動同期するとは限らない。
- Figma連携では、MCPが接続、Skillが作業手順の役割である。
- 外部Skillを入れる前には、スクリプトや参照ファイルの中身を確認するべきである。
- Skillは増やしすぎるより、用途が明確なものを少数精鋭で管理するほうが実用的である。
- AI回答だけで判断せず、公式ドキュメントとopenai/skillsリポジトリを確認するのが基本である。
- https://developers.openai.com/codex/skills
- https://github.com/openai/skills
- https://help.openai.com/en/articles/20001066-skills-in-chatgpt
- https://zhuanlan.zhihu.com/p/1986916268675187102
- https://www.reddit.com/r/ClaudeAI/comments/1rti39t/%E5%91%8A%E5%88%AB%E4%BA%BA%E8%82%89%E5%A4%8D%E5%88%B6%E7%B2%98%E8%B4%B4%E6%88%91%E7%9A%84_claude_codex_%E8%87%AA%E5%8A%A8%E5%8C%96%E5%8D%8F%E4%BD%9C%E5%B7%A5%E4%BD%9C%E6%B5%81/
- https://zhuanlan.zhihu.com/p/1985843947420014371
- https://help.figma.com/hc/en-us/articles/32132100833559-Guide-to-the-Figma-MCP-server
- https://medium.com/@markchen69/from-claude-skills-to-codex-a-beginner-friendly-companion-guide-cde8ca408a54
- https://code.visualstudio.com/docs/copilot/customization/agent-skills
- https://medium.com/@markchen69/skills-for-ai-agents-claude-codex-and-how-to-install-them-from-skill0-atypica-ai-1f0c9cf60547
各サイト運営者様へ
有益な情報をご公開いただき、誠にありがとうございます。
感謝の意を込め、このリンクはSEO効果がある形で設置させていただいております。
※リンクには nofollow 属性を付与しておりませんので、一定のSEO効果が見込まれるなど、サイト運営者様にとってもメリットとなれば幸いです。
当サイトは、インターネット上に散在する有益な情報を収集し、要約・編集してわかりやすくお届けすることを目的としたメディアです。
引用や参照の方法に不備、あるいはご不快に感じられる点がございましたら、お問い合わせフォームよりご連絡ください。
今後とも、どうぞよろしくお願いいたします。
