AIToday
用語解説

SKILL.md とは?AIに「この作業はこの手順で」を覚えさせる手順書

著者:(AITODAY プロダクトオーナー)

公開日:最終更新日:

SKILL.md とは?AIに「この作業はこの手順で」を覚えさせる手順書

この記事でわかること

  • 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 の形に当てはめて出力する

フォルダの中に SKILL.md を置いたところ

CLAUDE.md との違い

CLAUDE.mdSKILL.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. 本文はどれくらいの長さで書けばいいですか?
A. 500行以内が目安です。長くなる場合は、細かい資料を同じフォルダの別ファイルに分けて、本文から「必要なら○○.md を読む」と案内します。
Q. スクリプトも入れられますか?
A. 入れられます。同じフォルダに置いておき、手順の中で「このスクリプトを実行する」と書けば、AIがその場で使います。
Q. ほかのAIツールでも使えますか?
A. 対応しているツールなら、同じ SKILL.md をそのまま使えます。置き場所のフォルダはツールごとに違うので、各ツールの説明を確認してください。
Q. プログラミングができなくても作れますか?
A. 作れます。中身は日本語の手順書なので、いつも人に説明している手順をそのまま書けば動きます。

出典:Agent Skills 公式サイト

あなたの仕事に関係するAIニュースを、毎朝お届けします。

業界と使っているAIツールを選ぶと、仕事に関係するニュースが毎朝届きます。

登録無料・Googleアカウントなら30秒・いつでも解除できますAITodayについて →

関連記事