はじめに
AIエージェントに特定の作業を実行させる仕組みとして、Skillsがあります。
Skillsは、作業手順やスクリプト、参考資料などをまとめ、AIエージェントに必要なタイミングで利用させるための仕組みです。
基本的にはSKILL.mdというMarkdownファイルを中心に構成されますが、実際の配置場所や呼び出し方はAIエージェントによって異なります。
今回は、Claude CodeとCodexを例に、Skillsの扱いの違いについて整理してみます。
Skillsの基本的な構成
Skillsは、SKILL.mdを中心に、必要に応じてスクリプトや参考資料をまとめたディレクトリとして構成されます。
例えば、SharePointからファイルをダウンロードするSkillなら、以下のような構成が考えられます。
download-sharepoint/
├── SKILL.md
├── scripts/
│ └── download.py
└── references/
└── setup.md
SKILL.mdには、Skillの名前や説明、具体的な作業手順を記述します。
---
name: download-sharepoint
description: SharePointからファイルをダウンロードする
---
# SharePoint Download
## 手順
1. SharePointへの接続を確認する
2. 対象ファイルを特定する
3. ダウンロード処理を実行する
4. 保存結果を確認して報告する
## 注意事項
- 認証情報をコードに直接記述しない
- エラーが発生した場合は処理を中断する
このように、Skill自体の基本構造はClaude CodeとCodexで共通しています。
ただし、SKILL.mdは作業指示書であり、ファイルそのものがプログラムとして実行されるわけではありません。
AIエージェントが内容を読み取り、必要なツールやスクリプトを使って作業を進めます。
Claude CodeでのSkillsの扱い
Claude Codeでは、プロジェクト内の.claude/skills/にSkillを配置できます。
ディレクトリ構成
.claude/
└── skills/
└── download-sharepoint/
├── SKILL.md
└── scripts/
└── download.py
呼び出し方
Claude Code上で、以下のように入力します。
/download-sharepoint
対応するSkillが認識されていれば、Claude CodeがSKILL.mdを読み込み、記載された手順に沿って処理を進めます。
また、Skillの説明とユーザーの依頼内容が一致した場合、Claude Codeが自動的にSkillを選択することもあります。
CodexでのSkillsの扱い
Codexでも同様にSkillsを利用できますが、配置場所と明示的な呼び出し方が異なります。
ディレクトリ構成
Codexでは、プロジェクト内の.agents/skills/にSkillを配置できます。
.agents/
└── skills/
└── download-sharepoint/
├── SKILL.md
└── scripts/
└── download.py
呼び出し方
Codexでは、Skill名の前に$を付けて指定できます。
$download-sharepoint
Codex CLIやIDE拡張では、/skillsから利用可能なSkillを確認・選択する方法もあります。
Claude Codeと同様に、依頼内容がSkillの説明に一致した場合、Codexが自動的にSkillを選択することもあります。
Claude CodeとCodexの違い
両者の主な違いをまとめると、以下のようになります。
| 項目 | Claude Code | Codex |
|---|---|---|
| Skill定義ファイル | SKILL.md |
SKILL.md |
| プロジェクト内の配置場所 | .claude/skills/ |
.agents/skills/ |
| 個人用の配置場所 | ~/.claude/skills/ |
~/.agents/skills/ |
| 明示的な呼び出し | /skill-name |
$skill-name |
| Skillの自動選択 | 対応 | 対応 |
| スクリプトの同梱 | 可能 | 可能 |
大きな違いは、Skillの配置場所と、ユーザーが明示的に呼び出す際の記法です。
一方、SKILL.mdを中心に作業手順を定義し、AIエージェントが必要に応じて利用するという基本的な考え方は共通しています。
同じSkillを両方で使える?
基本的には可能です。
Claude CodeとCodexはどちらもSKILL.mdを中心としたSkillの構造を採用しているため、共通する手順を流用しやすくなっています。
ただし、同じSKILL.mdを作成しただけで、両方のAIエージェントが自動的に認識するわけではありません。
例えば、Claude Code向けに.claude/skills/へ配置したSkillは、Codexの標準的なSkill探索場所とは異なります。
両方で利用したい場合は、それぞれの対応ディレクトリに配置するか、対応する環境でシンボリックリンクなどを利用して共通管理する方法が考えられます。
また、Skill内で特定のAIエージェント専用機能を利用している場合、その部分は調整が必要になることがあります。
Skillsは呼び出すだけで実行される?
Skillsを明示的に呼び出すと、AIエージェントは定義された手順を参照して作業を進めます。
ただし、必ずしもすべての処理が自動的に完了するわけではありません。
例えば、SharePointからファイルをダウンロードするSkillであれば、SharePointへの接続設定や認証、ファイルへのアクセス権限が必要です。
また、スクリプトを実行できる環境や権限がなければ、Skillに記載された処理を実行できない場合もあります。
つまり、SkillsはAIエージェントに作業方法を教える仕組みであり、実際に何ができるかはAIエージェントの機能や実行環境に依存するということです。
まとめ
Claude CodeとCodexでは、Skillsの基本的な仕組みは共通していますが、配置場所や呼び出し方には違いがあります。
Claude Codeでは.claude/skills/に配置し、/skill-nameで呼び出せます。
一方、Codexでは.agents/skills/に配置し、$skill-nameで明示的に指定できます。
どちらもSKILL.mdを中心とした構成なので、作業手順を共通化しやすい一方、エージェント固有の機能や設定には注意が必要です。
Skillsは共通の考え方で作成できても、どのように認識し、呼び出し、実行するかはAIエージェントによって異なる。
この違いを理解しておくことで、複数のAIエージェントを利用する場合にも、Skillsを管理しやすくなると思います。