III.1 Skills

本章の位置づけ

第III部は、五層を一つずつ見る。Skills は、モデルの中に入っていない決まりを、必要なときに読める形で置く層である。作り方とホストごとの置き場は、下の How-to に残してある。

1.1 何を置くか

Claude は、一般的な書き方は知っている。こちらのプロジェクトの用語、レビューの合格線、訳の手順は知らない。それを毎回の会話に全部書くと、長くなるほど薄れる。

Skills は、その決まりを Markdown に書いておく層である。形式の中心は SKILL.md である。Agent Skills に沿った置き方をする製品が多い。読むだけで、外の API は叩かない。

たとえば翻訳なら、用語の統一と「xCOMET 0.85 を下回ったら差し戻す」は Skills に書く。辞書サービスを呼ぶのは MCP である。品質の下限そのものを、全仕事の物差しにするなら Doctrine である。

両方要ることが多い。Skills で「何を守るか」を書き、MCP で「いまの値を取る」を足す。使い分けの各論は MCP vs Skills を見る。

一つの Skill に、いくつかを混ぜてよい。混ぜすぎると、同時に出す指示が増えて守りが弱くなる。分けた方がよいときは、Agent 側で役割を分ける。

SKILL.md に書くとよい節は、目的、入出力、MUST / SHOULD、手順、判断の目安、よい例と悪い例、である。書き方の型は Skill設計ガイドにある。

Skills は、参照時だけ読まれる。いつも全部を載せるものではない。それが、Context Rot への答えである。仕組みは姉妹資料 Part 5: オンデマンドコンテキストを見る。

操作と実例は、次に残してある。消していない。

Skills は、変わらない知識と手順を置く。実行しない。チームの決まりはモデルの中には無いので、外に書いて、必要なときに読ませる。原文と操作は MCP、物差しは Doctrine、前回の続きは Memory である。