SKILL.md とは？Agent Skills が業界共通の規格に。MCP との違いと書き方

やっほー、ぼくてんびん丸！

AI に「いつもの仕事のやり方」を覚えさせるファイル、SKILL.md（スキルエムディー）って聞いたことある？ これを中心にした仕組み Agent Skills（エージェントスキル）が、10月22日に業界みんなの共通ルールになったんだ。

先に結論を言うね。Anthropic が Agent Skills を Linux Foundation の下の業界団体に寄贈して、特定の会社のものではなくなったよ。もう ChatGPT・Cursor・GitHub Copilot・VS Code など70以上のツールが対応していて、一度書いたスキルはどの AI に乗り換えても使い回せる流れがはっきりしたんだ。

何があったの？

Anthropic は2026年10月22日、Agent Skills を Agentic AI Foundation（AAIF） に寄贈したと発表したよ。AAIF は Linux Foundation の下にある団体で、Anthropic・Block・OpenAI が去年いっしょに立ち上げたところ。前に MCP（AI を外のサービスにつなぐ規格）も同じ団体に寄贈しているから、これで2つ目なんだ。

流れを整理すると、Anthropic は2025年10月に Claude Code の機能としてスキルを出し、2025年12月に共通規格として公開したよ。そこから約10か月で70以上のツールが取り込み、今回「どこか1社のもの」ではない場所に移したんだ。

これからは Anthropic・Google・OpenAI などのエンジニアが会社の代表ではなく個人として規格を管理するよ。AAIF に入らなくても、規格はこれまでどおり無料で使えるし、意見も出せると書かれているんだ。

SKILL.md とは？

SKILL.md は、AI に特定の仕事の手順を教えるための「説明書ファイル」だよ。 このファイルを入れたフォルダ1つが、1つの「スキル」になるんだ。

たとえるなら、新人さんに渡す業務マニュアルの1冊だね。「請求書を作るとき」「会議メモを報告書にするとき」みたいに仕事ごとに1冊ずつ作っておくと、AI は頼まれた仕事に合うマニュアルだけを棚から出して読むんだ。全部を毎回読むわけじゃないから、何十冊あっても AI の頭（コンテキストウィンドウ）がいっぱいになりにくいよ。

きみの使い方で変わるのは、「いつも同じ説明を貼っている」作業がなくなることだね。しかも共通規格だから、Claude 用に書いたスキルを ChatGPT や Cursor に持っていける。AI を乗り換えても、教えた手順が無駄にならないんだ。

中身はどうなっている？

公式の仕様書（agentskills.io）では、フォルダの中身はこう決まっているよ。

AI がスキルを読む順番は3段階になっていて、これが「何十冊あっても平気」な理由なんだ。

1. 起動したとき：全部のスキルの名前と説明だけ読む（1本あたり約100トークン）
2. 使うと決めたとき：そのスキルの SKILL.md の本文を読む（5,000トークン未満が目安）
3. 必要になったとき：references/ などのファイルを読む

SKILL.md の書き方

いちばん小さい SKILL.md は、冒頭の数行と本文だけで作れるよ。

---
name: meeting-notes
description: 会議の文字起こしを社内の報告書の形にまとめる。会議メモ・議事録・打ち合わせの要約を頼まれたときに使う。
---

## 手順
1. 決まったことを箇条書きで最初に書く
2. 次にやることを「誰が・いつまでに」の表にする
3. 最後に、決まらなかったことを書く

決まりはこのくらいだよ。

• name：64文字まで。小文字の英数字とハイフンだけで、フォルダ名と同じにする（Meeting-Notes や meeting--notes はだめ）
• description：1,024文字まで。「何をするか」と「いつ使うか」の両方を書く。AI はここを見て使うかどうか決めるから、「会議メモ」「議事録」みたいに頼まれそうな言葉を入れておくのがコツなんだ
• 本文：書き方は自由。手順・入力と出力の例・つまずきやすい場合を書くのがおすすめ
• 長さ：SKILL.md は500行以内に収めて、長い資料は references/ に分けるよう公式は勧めているよ

Claude Code なら、自分用のスキルは ~/.claude/skills/<スキル名>/SKILL.md に置けば使えるようになるよ。チャット版の Claude では、［カスタマイズ］→［スキル］（英語画面では Customize > Skills）からフォルダを ZIP にしてアップロードするんだ。Free・Pro・Max・Team・Enterprise の全プランで使えるけど、設定の［機能］（Capabilities）にある「コード実行とファイル作成」をオンにする必要があるよ。ほかのツールの置き場所は、agentskills.io の対応ツール一覧に各ツールの設定手順へのリンクがあるから、そこから確かめてね。

MCP・プロンプト・プラグインとの違いは？

似た言葉が多いから、表にまとめたよ。

いちばん混ざりやすいのが MCP との違いだね。Claude の公式ヘルプは「MCP で道具を使えるようにして、スキルで道具の使い方を教える」という組み合わせ方を案内しているよ。たとえば MCP で社内のタスク管理ツールにつなぎ、スキルで「うちのチームはこういう書き方でタスクを作る」と教える、という分担なんだ。

RAG とも違うよ。RAG は資料を検索して答えの材料を足す仕組みで、スキルは仕事の進め方を教える仕組み。材料と手順の違い、と覚えておくとわかりやすいね。

Agent Skills の評判は？Xの反応

Xでは、「一度書けばどの AI でも使える」ことと「毎回プロンプトを書かなくて済む」ことを喜ぶ声が目立ったよ。不満は、共有したスキルを直しても相手に反映されにくいという運用の話が出ていたんだ。

寄贈の意味を「どの AI に乗り換えても手順が無駄にならない」とまとめた声だよ。

繰り返す仕事を全部 SKILL.md にしていて、18本・計2,002行で毎日の作業を回しているという声もあったよ。

一方で、共有した相手側で SKILL.md の更新がなかなか反映されない、という不満の声だよ。

ほかにも、「AI を替えるたびにメールの書き方から教え直す手間が減りそう」という受け止め方が多かったよ。10月24日時点で、実在を確認できたXのポストから選んだよ。

1週間後の反応（11月1日時点）

1週間たつと、寄贈そのものの話より、自分の仕事や道具に合わせたスキルを作って配る話が増えてきたよ。CMS 用やゲーム開発用のスキル集を公開したという投稿が続いていて、受け止め方は良い評価が中心のまま。11月1日時点で、新しく確認できたポストに不満の声は無かったんだ。

使っている CMS でのサイト制作やプラグイン開発に向けて、スキルを準備しているという声だよ。

寄贈を「AI への仕事の教え方の共通化」と受け止めて、AI を替えても説明し直さずに済むことを喜ぶ声だよ。

ぼくの見解

ぼくがいちばん大きいと思うのは、ここ数か月で大手3社が別々に「スキル」に寄ってきていた流れに、共通の土台ができたことだよ。サイトで追ってきた記事を並べるとよくわかるんだ。

特に Gemini は Gem をやめて SKILL.md 形式のスキルに切り替えるところまで来ているよ。ライバル会社の規格に乗り換えるくらいだから、SKILL.md は「Claude の機能」から「AI の共通の書式」になったと言っていい気がする。

だから、いま手順書を書くなら SKILL.md の形で書いておくのがいちばん損しないとぼくは思うよ。Claude Code の設定ガイドで紹介した CLAUDE.md は「その道具専用の決まりごと」、SKILL.md は「どの道具にも持っていける手順書」と分けて考えるとすっきりするんだ。

気をつけたいのは安全面だね。スキルにはプログラム（scripts/）を入れられるから、知らない人が作ったスキルを入れるのは、知らないアプリを入れるのと同じくらい注意がいるよ。AAIF のこれからの予定に「スキルを入れる人向けの安全の指針」が入っているのは、そこを心配しているからだと思うんだ。指針が出るまでは、中身を読んで納得できたスキルだけ入れるのがいいかもしれないね。

まとめ

• SKILL.md は AI に仕事の手順を教える説明書ファイルで、フォルダ1つが1つのスキルになるよ
• 10月22日に Agent Skills は業界団体 AAIF に寄贈され、ChatGPT・Cursor・GitHub Copilot など70以上のツールで使える共通規格になったんだ
• MCP は「つなぐ線」、スキルは「使い方の手順書」。必要なときだけ読み込まれるのがプロンプトやカスタム指示との違いだよ
• 書くときは name と description の2つが必須、本文は500行以内が目安

毎回同じ説明をコピペしているなら、それがきみの最初のスキルの材料だよ。まずは1本、短い SKILL.md を書いてみてね！