AIエージェント（Antigravity、Cursor、Claude等）を使って開発や業務自動化を行う中で、「毎回同じ指示や手順をプロンプトで説明するのが面倒…」「特定の業務手順をAIに記憶させて再現させたい」と思ったことはありませんか？
そんな悩みを一発で解決するのが、AIエージェントの拡張仕様機能である「SKILL.md」です！
この記事では、SKILL.md の基本的な概念から、ルール（AGENTS.md）との違い、実際の書き方やフォルダ構成、活用例までを完全解説します。
SKILL.mdの基本概要
SKILL.md とは、AIエージェントに「特定の専門スキル（作業手順・ノウハウ・ツール連携ルール）」を学習させ、必要に応じて動的に読み込ませるための専用指示ファイルです。
YAMLフロントマター（メタ情報）とMarkdown本文で構成されており、AIがユーザーの依頼内容に応じて「今どのスキルが必要か」を自動判断して読み込みます。
SKILL.mdがもたらす3つのメリット
- プロンプトのコピペが不要に：何度も繰り返す指示をファイル化して自動適用
- コンテキスト（文量）の節約（プログレッシブ・ディスクロージャー）：必要な時だけフル文言を読み込むため、AIの動作が重くならない
- チームでのノウハウ共有：リポジトリや設定フォルダに保存することで、チーム全員のAIが同じ品質で動作
Rules（AGENTS.md）とSkills（SKILL.md）の違い
AIエージェントの設定ファイルには、常時適用される「ルール（Rules）」と、オンデマンドで呼び出す「スキル（Skills）」の2種類があります。
| 比較項目 | Rules（AGENTS.md / rules/） | Skills（SKILL.md） |
|---|---|---|
| 読み込みタイミング | 常に有効（常時ロード） | 必要時のみ自動呼び出し（動的ロード） |
| 主な用途 | コーディング規約、禁止事項、出力スタイル | 特定の業務手順、デプロイフロー、レポート生成 |
| 消費トークン | 毎回の対話でトークンを消費 | 使う瞬間まで概要のみ保持（軽量） |
SKILL.mdの基本構造とコード例
SKILL.md は、上部のメタデータ（YAML Header）と本文（Markdown）の2つの部分で構成されます。
---
name: wordpress-article-publisher
description: >-
WordPressへのブログ記事投稿およびメタデータ設定を行う標準手順スキル。
記事公開依頼があった場合に適用。
---
# WordPress 記事投稿スキル手順書
このスキルは、AIエージェントがWordPressへ記事を安全かつ正確に入稿・自動公開するための標準ガイドラインです。
## 実行フロー
1. 原稿HTML・Markdownの生成
2. 見出し規約チェック（数字・連番が含まれていないか確認）
3. REST API経由での投稿実行
4. ステータス（200 / 201）および公開URLの確認とユーザー報告
SKILL.mdのフォルダ配置ルール
SKILL.md は、作成する目的に応じて「特定プロジェクト専用（ローカル）」または「PC全体共通（グローバル）」のどちらかに配置します。
skills/
└── my-automation-skill/
├── SKILL.md (必須: スキル指示書)
├── scripts/ (任意: 実行ヘルパースクリプト)
└── references/ (任意: 補足資料やテンプレート)
- プロジェクト専用（推奨）: リポジトリルートの
.agents/skills/スキル名/SKILL.mdに配置 - グローバル共通: ユーザーディレクトリの
~/.gemini/config/skills/スキル名/SKILL.mdに配置
効果的なSKILL.mdを作成するベストプラクティス
AIエージェントは description を見てスキルの要否を判定します。「どんな時に使うスキルか」をトリガー条件も含めて明確に記述しましょう。
箇条書きやステップ順を整理して書くことで、AIの迷いや誤動作を劇的に防ぐことができます。
スキルフォルダ内に scripts/ や references/ を置くことで、スクリプトの直接実行やサンプルコードの参照が容易になります。
まとめ
SKILL.md は、AIエージェントを「ただのチャットAI」から「自社の業務を完全に理解した専属エキスパート」へと昇華させる強力なツールです。
ルーティン作業や複雑な手順がある場合は、ぜひ自分だけの SKILL.md を作成して、AIとのペアプログラミング・業務自動化をさらに効率化してみてください！
