Agent Skills（スキル）とは？Claude Code・Codexでの作り方と、CLAUDE.md・MCP・プロンプトとの違い

Agent Skills（スキル）とは、AIエージェントに仕事の手順や専門知識を渡すためのフォルダです。中心にSKILL.mdという説明書があり、必要ならスクリプトやひな形も一緒に入れられます。

似た仕組みとの違いは、いつAIに読み込まれるかです。CLAUDE.mdなどの設定ファイルは毎回読まれ、プロンプトは毎回書き、スキルは仕事の内容が合ったときだけ読み込まれます。

この記事では、スキルの仕組み、近い仕組みとの違い、Claude Code・Codex・Claudeアプリでの使い方、作り方と注意点を順に見ていきます。読み終えると、手元の作業をスキルにするかどうかと、その作り方を決められます。

スキルとは、必要なときだけ読み込まれる「手順書のフォルダ」

スキルの中身は、1つのフォルダです。SKILL.mdの先頭に「名前」と「何をするスキルで、いつ使うか」の説明を書き、その下に手順を書きます。

たとえば「請求書PDFから金額と期日を抜き出して表にする」スキルなら、抜き出す項目の一覧、表の形、確認のしかたを書いておきます。PDFを読むスクリプトを同じフォルダに入れておけば、AIはそれを動かして結果だけを受け取ります。

手順は、新しく入った人に渡す引き継ぎ資料のつもりで書くと過不足が出にくくなります。Anthropicも、スキル作りを新しいメンバー向けの手引き作りにたとえています。

読み込みは3段階です。Anthropicの資料によると、起動時は各スキルの名前と説明だけ（1つ約100トークン）を読み、仕事が説明に合ったときに本文（5,000トークン未満）を読み、スクリプトや資料は使うときだけ開きます。

この仕組みのおかげで、スキルをたくさん入れておいても、使わないスキルがAIの読める量を圧迫しません。

スキルはAnthropicが2025年10月にClaude向けに発表した形式で、いまは公開の標準としてCodex、Gemini CLI、GitHub Copilot、Cursorなど多くの製品が対応しています。

近い仕組みとの違いは「いつ読み込まれるか」と「何を足すか」

AIへの指示を残す方法はいくつかあり、置き場所と読み込まれる時が違います。スキルにするか迷ったら、この表で決めます。

仕組み	いつ読み込まれるか	何を書くか	例
プロンプト	その場で毎回書く	今回の依頼	「この議事録を3行で要約して」
CLAUDE.md・AGENTS.md	作業を始めるたびに毎回	どの作業でも守ってほしい決まり	「回答は日本語で」「テストを通してから終える」
スキル	仕事の内容が説明に合ったときだけ	特定の作業の手順と道具	「請求書の読み取り」「週報の作り方」
MCP	接続した外部ツールを使うとき	外部のサービスへのつなぎ方	GitHubやNotionへの接続

毎回守ってほしい短い決まりは、CLAUDE.mdやAGENTS.mdに書きます。違いの詳細はAGENTS.mdとはで見られます。

特定の作業だけで使う長い手順は、スキルに分けます。全部を設定ファイルに書くと、関係ない作業のたびに長い手順まで読まれ、AIが読める量を無駄に使います。

MCPは外部のツールにつなぐ仕組みで、スキルはそのツールを使う手順を教える仕組みです。Anthropicも、2つは競合ではなく組み合わせて使うものだと説明しています。

Claude Code・Codex・Claudeアプリでの置き場所と使い方

製品ごとに、スキルを置く場所と呼び出し方が少しずつ違います。2026年10月4日に各社の公式ドキュメントで確認した内容を並べます。

製品	置き場所	呼び出し方
Claude Code	自分用は ~/.claude/skills/、プロジェクト用は .claude/skills/	説明に合う依頼で自動、または /スキル名
Codex	自分用は ~/.agents/skills、リポジトリ用は .agents/skills	説明に合う依頼で自動、または $スキル名、/skills で一覧
Claudeのアプリ	設定の「スキル」からZIPでアップロード	説明に合う依頼で自動

Claude Codeでは、以前の「カスタムコマンド」がスキルにまとめられました。.claude/commands/ に置いていたファイルも動きますが、補助ファイルを持てるスキルの形が勧められています。

プロジェクト用のフォルダに置いたスキルは、リポジトリに入れればチーム全員で同じ手順を使えます。

たとえば「リリース前の確認手順」をスキルにしておけば、誰がAIに頼んでも同じ順番で確認が進みます。

Claudeのアプリでアップロードしたスキルは本人だけのものなので、チームで使うなら各自がアップロードします。

Claude Codeのスキル、アプリのスキル、APIのスキルは互いに同期しないので、使う場所ごとに入れます。Claude Codeで作ったスキルをアプリでも使いたいときは、フォルダをZIPにまとめてアップロードし直します。

Claude CodeとCodexのどちらで使うか迷ったら、Claude CodeとCodexの比較が参考になります。スキルに対応した開発ツールはAIコーディングのカテゴリから探せます。

作り方は「3回くり返した作業」から、他人のスキルは中身を読んでから入れる

最初のスキルは、同じ説明をAIに3回以上した作業から作ると外れません。週報のまとめ方、コードレビューで見る点、社内の資料の体裁などが候補です。

反対に、1回きりの作業や、毎回やり方が変わる作業はスキルに向きません。その場のプロンプトで頼んだほうが早く済みます。

作るときに一番大事なのは、SKILL.mdの説明文です。AIは説明文を読んで使うかどうかを決めるので、「何をするか」と「どんな依頼のときに使うか」を両方書きます。

たとえば「週報を作る」だけでは足りず、「今週のコミットと議事録から週報を作る。週報、今週のまとめ、と頼まれたときに使う」まで書きます。

ここまで書くと、呼び出されるべき場面で使われやすくなります。

作ったあとに、頼んでもスキルが使われない、関係ない依頼で使われる、といったずれが出たら、まず説明文を直します。Codexには、スキルの下書きを作る「Skill Creator」というスキルが最初から入っています。

他人が作ったスキルを入れるときは、ソフトを入れるときと同じ注意が要ります。Anthropicは、自分で作ったものか信頼できる提供元のものだけを使うよう求め、悪意のあるスキルはAIに想定外の操作をさせうると警告しています。

入れる前に、SKILL.mdとスクリプトを開いて、外部のURLへデータを送る処理や、関係ないフォルダを触る処理がないかを確かめます。特に外部のURLから内容を取ってくるスキルは、取ってきた内容に悪い指示が混ざる危険があるとされています。

まとめ

スキルは、AIエージェントに仕事の手順や専門知識を渡すフォルダで、仕事の内容が合ったときだけ読み込まれます。毎回守る決まりはCLAUDE.mdやAGENTS.mdに、特定の作業の手順はスキルに、と分けて使います。

最初の1つは、Claude CodeやCodexで、同じ説明を何度もしている作業を選び、説明文を丁寧に書いたSKILL.mdを1枚作るところから始められます。

社内の業務手順をスキルにしてAIに任せたいものの、どの作業から始めるか、チームでどう共有して管理するかに迷う場合は、運営会社のAIリスキルがご相談を受けています。

お問い合わせはこちら

この記事の出典

• Agent Skills（Claude Platform Docs、2026年10月4日確認）
• Extend Claude with skills（Claude Code Docs、2026年10月4日確認）
• Using Skills in Claude（Claude Help Center、2026年10月4日確認）
• Build skills（OpenAI、2026年10月4日確認）
• Agent Skills Overview（agentskills.io、2026年10月4日確認）
• Equipping agents for the real world with Agent Skills（Anthropic Engineering Blog、2026年9月13日確認）