SKILL.mdとは：繰り返すAI作業を標準化する方法
この記事で学べること
- SKILL.mdが繰り返す専門作業を標準化する仕組み
- 一度限りの依頼や汎用指示と、Skillへ残す手順の違い
- Skillの対象、入力、手順、成果物、確認条件を設計する方法
繰り返すAI作業はSKILL.mdで標準化する
SKILL.mdは、繰り返す専門作業の対象、手順、制約、成果物、確認条件をAIへ渡すための指示ファイルです。このサイトでは、会話ごとに再説明していた手順をSkillへ移し、前提や確認項目の抜けを減らしました。一回限りの依頼や全作業へ常時適用する方針とは、役割を分けて管理します。
この記事では、「どの指示をSKILL.mdへ残し、どの指示を一回限りの依頼にするか」という問いに焦点を当て、中心概念の仕組み、混同しやすい境界、実務での判断材料を扱います。
最後まで読むと、「どの指示をSKILL.mdへ残し、どの指示を一回限りの依頼にするか」という問いを、自分の状況に照らして判断するための材料を持ち帰れます。
繰り返す専門作業をSKILL.mdへまとめる
特定の作業をAIへ依頼するたびに、手順、制約、出力形式を説明し直すと、指示の省略や解釈差が生じます。この状況を改善するために導入したのが「スキルファイル（SKILL.md）」という仕組みです。
この記事ではスキルの対象範囲、手順、禁止事項を設計する一般原則を扱います。ブログ制作支援への具体的な適用はブログ記事のドラフト作成をAIで支援する方法に分けています。
SKILL.mdは手順・制約・出力形式を再利用可能にする
スキルファイルは、特定のタスクについて「何をどういう手順で、どんな注意点を守りながら、どういうアウトプット形式で行うか」を定義したMarkdownファイルです。
本記事のSKILL.mdは、このサイト内で使っている作業定義ファイルを指します。Claude Code Skills、Codex Skills、GitHub Copilotの関連機能など、各ツールが提供する公式機能名とは意味や読み込み方法が異なる場合があります。
カレーにたとえると、材料の名前だけでは同じ仕上がりになりません。材料の量、切り方、入れる順番、火加減、完成を判断する基準までレシピにすると、作る人が変わっても仕上がりのばらつきを減らせます。
この対応では、材料が入力情報、作り方が手順、使えない材料や調理器具の条件が制約、完成したカレーが成果物、味見が確認条件に当たります。Skillは、担当者の頭の中にあった職人技や暗黙知を、別の人やAIも参照できる「持ち運べる業務のレシピ」と整理できます。
ただし、レシピが材料や調理器具の違いまでなくせないように、Skillも同じ結果を保証するものではありません。実際の入力、利用環境、人の確認と組み合わせることで、繰り返す作業のばらつきを減らします。
このサイトでは執筆・レビュー・ドキュメント作成のSkillを分ける
実際にこのサイトのハーネス（AIに渡すルール、作業手順、検証方法をまとめた仕組み）に組み込んだスキルファイルをいくつか紹介します。
ブログ執筆スキル（my-blog-writing/SKILL.md）
ブログ執筆Skillは、frontmatter（記事先頭のtitle、description、dateなどの設定情報）を扱います。著者ボイス、日英記事の作成順序、参考文献形式も定義しています。
このSkillを参照すれば、記事ごとに文体や構成のルールを再説明する必要がありません。
コンテンツ校閲スキル（editorial-review/SKILL.md）
記事を公開する前にチェックする項目の一覧と、Critical（公開停止）とRecommended（推奨修正）の判定基準を定義しています。
ドキュメント作成スキル（docs-content/SKILL.md）
ドキュメントページの構成ルール（クイズの追加要件、見出し階層、対象読者ブロックの有無）を定義しています。
その場の指示は一回限り、Skill定義は次の作業でも再利用する
汎用指示は「そのとき伝えた内容だけ」有効です。会話が変わればリセットされます。スキルファイルは、ファイルとしてリポジトリに存在するため、次の会話でも参照できます。
また、スキルファイルはチームで共有できます。複数人がAIに依頼する場合でも、同じスキルファイルを参照させることで、担当者が変わっても一定の品質を保ちやすくなります。
Skill設計では適用条件・手順・成果物・検証方法を決める
スキルファイルを作るとき、私が最初に整理するのは次の3点です。
- 何のタスクか：スキルの対象範囲を明確にする（「記事を書く」ではなく「このサイトのブログ記事を著者ボイスで書く」）
- どんな手順か：ステップを具体的に並べる
- 何を禁止するか：AIが誤った選択をしやすい点を明示する
範囲が広すぎるスキルは再現性が下がります。「ライティング全般」より「このサイトのブログ記事作成」のように、タスクの範囲を絞る方が、実際の出力が安定します。
まとめ：繰り返す専門作業だけをSKILL.mdへ残す
SKILL.mdは、AIへの繰り返し指示をファイルとして定義し、再利用可能にする仕組みです。毎回の指示内容をスキルファイルに移すことで、作業の再現性が上がり、指示の省略による品質のばらつきを減らせます。
次のステップとして、既存のスキルファイルが実際のコードや設定と一致しているかを定期的に確認する「ドリフト検出」の仕組みも必要になります。それについては別の記事で説明します。
最初に繰り返した作業を1つ選び、対象、入力、手順、成果物、検証条件を書き出します。一度限りの依頼や、すべての作業で守る方針はSkillへ詰め込まず、会話や共通ルールに残してください。