エージェントスキルとは?1つのSKILL.mdをClaudeとCodexで使う方法
Claudeに書いた作業手順をCodexやGemini CLIでも使うために、ツールごとに設定ファイルを作って同じ内容をコピーしていませんか?ツールが増えるほど手順書が分かれ、一部だけを更新した結果、ツールごとに結果が少しずつ異なることがあります。
エージェントスキル(Agent Skills)は、SKILL.mdファイルを使ってAIに作業手順を伝える公開仕様です。Anthropicが2025年12月に公開し、2026年10月22日にLinux Foundation傘下のAgentic AI Foundation(AAIF)に寄贈しました。発表時点では、ChatGPT、Cursor、GitHub Copilot、VS Codeなど、70を超えるエージェントツールが対応しています。この記事では、スキルの構成と運営主体の変更、複数のツールで使う手順、説明文の書き方、セキュリティの確認項目を紹介します。dagloで文字起こしした会議の記録をスキルに渡す流れも取り上げます。
エージェントスキルとは?SKILL.mdでAIに作業手順を伝える仕様

エージェントスキルは、1つのフォルダにSKILL.mdと参考資料をまとめた作業手順書です。AIは最初にスキルの名前と説明だけを読み込み、依頼が説明に合うときに本文を読んで、その手順に沿って作業します。
- SKILL.md:冒頭のYAMLに名前(name)と説明(description)を書き、その下にMarkdownで作業手順を記述します。このファイルだけでもスキルとして使えます。
- scriptsフォルダ:AIが実行するコードを置きます。計算など、毎回同じ結果が必要な処理は、文章で指示するよりコードで実行するほうが正確です。
- referencesフォルダ:テンプレートや用語集、長い説明など、必要なときにだけ読む資料を置きます。
- 段階的な読み込み:名前と説明を先に読み込み、本文や参考資料は必要に応じて読み込むため、スキルが増えてもAIが最初に読む分量はほとんど増えません。
Claude Codeで初めてスキルを作成する手順は、Claude Codeのスキル作成ガイド(英語)で紹介しています。この記事では、同じスキルを複数のツールで使う方法に焦点を当てます。
Linux Foundation傘下のAAIFに移管された意味
運営主体が一企業から中立的な財団に移ったことで、自分で作ったスキルは、特定の企業の判断に左右されにくくなりました。仕様の名称とロゴ、GitHubの組織、agentskills.ioのドメインがAAIFに移管されました。
| 項目 | 変更内容 | 作成したスキルへの影響 |
|---|---|---|
| 運営主体 | AnthropicからLinux Foundation傘下のAAIFへ | 特定のツールに依存しない共通仕様として運営されます |
| 保守・運営 | Anthropic、Google、OpenAIなどのエンジニアが個人として参加 | 複数の企業の開発者が仕様の策定に関わります |
| SKILL.mdの形式 | 変更なし | 既存のスキルは引き続き動作します |
| 今後の計画 | バージョンごとのリリース、正式な提案手続き、セキュリティ指針を提案 | バージョン番号やセキュリティ基準が設けられたら、スキルを確認します |
同日、AAIFはOpenAIのOpen Responsesなどのプロジェクトも受け入れ、初年度に10件を運営することになりました。AIを外部ツールにつなぐ標準のMCPもAAIFのプロジェクトです。ツールとの接続にMCP、作業手順にスキルを使うという役割分担が明確になります。ChatGPTの構成要素との比較は、ChatGPTプラグイン・MCP・スキルの比較記事(英語)にまとめています。
SKILL.mdの例と、複数のツールで使う手順

スキルのフォルダを1つ作り、各ツールが読み込む場所に配置します。ここでは、会議の文字起こしからフォローアップメールの下書きを作るスキルを例にします。
- フォルダを作成:スキルと同じ名前のフォルダを作り、SKILL.md、テンプレート、スクリプトを入れます。
- SKILL.mdを記述:名前は英小文字、数字、ハイフンで64文字以内にし、フォルダ名とそろえます。名前の先頭と末尾にハイフンは使えません。説明は1,024文字以内で記述します。
- ツールごとの場所に配置:同じフォルダを、各ツールが読み込むスキルフォルダにコピーするか、リンクを作成します。
- 呼び出しを確認:各ツールで説明に合う依頼を行い、スキルが呼び出されるか、結果がそろうかを確認します。
meeting-followup-email/├── SKILL.md├── references/email-template.md└── scripts/extract_actions.py
---name: meeting-followup-emaildescription: 会議の文字起こしを読み、出席者に送るフォローアップメールの下書きを作成する。「会議のフォローアップメール」「会議後のメールを書いて」という依頼に使用する。---1. 文字起こしから決定事項、作業と担当者、次の予定を抜き出す。2. references/email-template.mdに沿ってメールの下書きを作成する。3. 文字起こしにない情報は補わず、[確認が必要]と記す。4. メールは送信せず、下書きだけを提示する。
| ツール | プロジェクトのスキル配置先 | 直接呼び出す方法 |
|---|---|---|
| Claude Code | .claude/skills/スキル名/SKILL.md | /スキル名 |
| Codex CLI | .agents/skills/スキル名/SKILL.md | $スキル名 |
| その他の対応ツール | 各ツールのドキュメントに記載されたスキルフォルダ | ツールによって異なります |
原本を1か所(例:.agents/skills)に置き、ほかのツールのフォルダからその場所にリンクすれば、一度の変更をすべてのツールに反映できます。対応ツールや読み込み先は変わることがあるので、agentskills.ioのツール一覧と各ツールの公式ドキュメントを確認してください。複数のスキルをまとめてチームに配布する方法は、Claude Codeプラグインの記事(英語)をご覧ください。
呼び出されやすい説明文とセキュリティの確認項目

AIは説明文をもとにスキルを呼び出すかを判断します。何をするスキルか、どのような依頼で使うかを説明に含めます。他者が作成したスキルは、インストールする前にフォルダ内のファイルを確認します。
説明文の書き方
- 最初の文に作業を書く:「会議の文字起こしからフォローアップメールの下書きを作成する」のように、成果物を明記します。
- 利用者が実際に使う表現を書く:「会議後のメールを書いて」のような依頼文を含めると、自動で呼び出されやすくなります。
- 似たスキルとの使い分けを書く:「議事録全体の整理にはmeeting-summaryを使う」など、使用しない場面も明記します。
セキュリティの確認項目
- scriptsフォルダ内のコードが何を実行するかを確認し、外部の送信先にデータを送らないかを点検します。
- 本文に「以前の指示を無視せよ」など、意図しない指示が埋め込まれていないかを確認します。
- メール送信、削除、デプロイなど取り消しにくい作業は、下書きや準備までに留め、人が確認してから実行します。
- パスワード、APIキー、顧客情報をSKILL.mdや参考資料に記載しません。
- 出所が明確なリポジトリのスキルを使い、更新された場合は変更内容を確認します。
隠された指示でAIを操作する攻撃については、プロンプトインジェクション対策の記事(英語)で詳しく紹介しています。
dagloの会議記録からフォローアップメールの下書きを作る

スキルは、入力形式が一定のときに安定して動作します。dagloで会議を文字起こしすると、発言者を区別した記録と要約が残り、フォローアップメールを作るスキルに渡せます。
- 録音して文字起こし:dagloで会議を録音するか、録音ファイルをアップロードすると、文字起こしと要約が作成されます。
- 名前が付いた文字起こし:dagloのボイスマッチは出席者の声を記憶し、次回の録音から「参加者1」などの代わりに実際の名前を自動で表示します。発言者の名前があれば、スキルは各作業の担当者を正確に記載しやすくなります。
- スキルに渡す:文字起こしをテキストとして書き出して作業フォルダに置き、「この会議のフォローアップメールを書いて」と依頼すると、どのツールでも同じ書式の下書きを作れます。
- 元の発言と照らし合わせる:ボードチャットに「決定事項と担当者だけ整理して」と尋ね、メールの下書きと比較すれば、抜けを見つけられます。
会議ごとに同じ形式で要約したい場合は、要約の指示をdagloのマイテンプレートに保存してください。録音が終わるたびに、その形式で自動的に要約されるため、スキルに渡す入力形式をそろえられます。
エージェントスキルは、1つのSKILL.mdで複数のAIツールに同じ手順を伝える共通仕様です。Linux Foundationへの移管により、特定のツールに依存しない運営基盤ができました。まずは原本を1つ作って各ツールにつなぎ、説明文とセキュリティの確認項目を整えましょう。対応ツールや細かな仕様は変わることがあるので、始める前にagentskills.ioを確認してください。
#エージェントスキル #AgentSkills #SKILLmd #ClaudeCode #Codex #LinuxFoundation #業務自動化 #daglo
会話を、次の仕事へ
今すぐ無料で始めてみてください