SKILL.md とは?AIに「この作業はこの手順で」を覚えさせる手順書
著者:高橋 輝(AITODAY プロダクトオーナー)
公開日:最終更新日:

この記事でわかること
- SKILL.md は作業1つ分の手順書で、フォルダ1つがスキル1つになる
- 先頭に書くのは name と description の2項目(標準では必須、Claude Code では省略もできる)
- 本文は使うときだけ読まれるので、たくさん入れても重くなりにくい
Claude Code、Cursor、Codex などが対応する SKILL.md(Agent Skills)の仕組みと書き方。CLAUDE.md との違いと、日報づくりのスキル例。
一言でいうと、SKILL.md は「この作業はこの手順でやる」をAIに覚えさせるための手順書です。CLAUDE.md が毎回読む「ルール」なのに対して、SKILL.md はその作業のときだけ開く「マニュアル」です。
SKILL.md とは
Anthropic が2025年に出した Agent Skills という形式で、今は agentskills.io で公開されているオープンな標準です。Claude Code、Cursor、OpenAI Codex、Gemini CLI、VS Code、GitHub Copilot など、多くのツールが対応しています。
スキルは「フォルダ1つ」で、その中に SKILL.md を1つ置きます。必要なら、手順で使う資料やスクリプトも同じフォルダに入れられます。
daily-report/
SKILL.md ← 必須。手順書の本体
template.md ← 日報のひな形(あれば)
examples.md ← 書き方の見本(あれば)
中身の形
先頭に name と description の2項目を書き、その下に手順を書きます。Agent Skills の標準ではこの2つが必須です。Claude Code では省略もでき、name が無ければフォルダ名が使われますが、description は書いておく方が確実です(理由は後で説明します)。
---
name: daily-report
description: その日の作業メモから日報を作る。「日報作って」「今日の報告まとめて」と頼まれたときに使う。
---
# 日報の作り方
1. 今日やった作業を箇条書きで並べる(時刻は書かない)
2. 作業ごとに、結果を1行で添える
3. 最後に「振り返り」を1つだけ書く
4. template.md の形に当てはめて出力する

CLAUDE.md との違い
| CLAUDE.md | SKILL.md | |
|---|---|---|
| 読まれるタイミング | 毎回、最初に必ず | その作業が必要なときだけ |
| 書く内容 | いつも守るルール | 作業ごとの手順 |
| 数 | プロジェクトに基本1つ | いくつでも |
毎回守ることは CLAUDE.md、決まった作業の手順は SKILL.md と分けると、どちらも短く保てます。CLAUDE.md の詳しい説明は「CLAUDE.md とは?」をどうぞ。
必要なときだけ読む仕組み
AIは最初、すべてのスキルの name と description だけを読みます。頼まれた作業に合いそうなスキルが見つかったら、そこで初めて SKILL.md の本文を読み、さらに必要なら同じフォルダのほかのファイルを開きます。
この仕組みのおかげで、本文は使うときだけ読まれるので、スキルをたくさん入れても重くなりにくい(name と description の分だけは毎回読まれます)。
ポイントAIがスキルを使うかどうかは description で決まります。「何をするか」と「どんな頼まれ方をしたら使うか」の両方を書いてください。
Claude Code での置き場所
- 自分のすべてのプロジェクトで使う:
~/.claude/skills/スキル名/SKILL.md - そのプロジェクトだけで使う:
.claude/skills/スキル名/SKILL.md
このほか、プロジェクトのサブフォルダの .claude/skills/、プラグイン、会社が配るスキルなどの置き場所もあります。
置いておくと、頼まれた内容に合わせて Claude が自分で使います。自分で呼び出したいときは /スキル名 と打ちます。
よくある勘違い
- 「プログラミングができないと作れない」:作れます。中身は日本語の手順書です。
- 「全部 CLAUDE.md に書けばいい」:重くなります。CLAUDE.md は毎回読まれるので、作業手順まで入れると大事なルールが埋もれます。
まとめ
SKILL.md は、決まった作業の手順をAIに覚えさせるための手順書です。人に何度も説明している作業があれば、それをそのまま1つのスキルにするところから始めてみてください。
次に読む
よくある質問
Q. 本文はどれくらいの長さで書けばいいですか?
Q. スクリプトも入れられますか?
Q. ほかのAIツールでも使えますか?
Q. プログラミングができなくても作れますか?
あなたの仕事に関係するAIニュースを、毎朝お届けします。
業界と使っているAIツールを選ぶと、仕事に関係するニュースが毎朝届きます。
登録無料・Googleアカウントなら30秒・いつでも解除できますAITodayについて →
関連記事
- 用語解説
Copilot Chat(Basic)とは?ExcelやWordからCopilotが消えた理由
ExcelやWordからCopilotが消えたときに出る「Copilot Chat(Basic)」の意味を、専門用語なしで解説。ライセンスなしで使える範囲、使い続ける方法と料金。
- 用語解説
AIエージェントとは?「答える」AIから「やっておいてくれる」AIへ
ニュースで毎日のように見る「AIエージェント」の意味を、専門用語なしで解説。チャットAIとの違い、何ができるか、仕事で使うときの注意。
- 用語解説
コンテキストエンジニアリングとは?プロンプトの「書き方」より「何を渡すか」
プロンプトエンジニアリングの次に注目されているコンテキストエンジニアリングの意味を、専門用語なしで解説。何が違うのか、CLAUDE.md・RAG・MCPとの関係、今日からできること。

