anthropics/skills

同じ依頼をしても、Claude の出来には毎回ばらつきが出る。社内の書式、いつもの手順、避けたい書き方。それを毎回プロンプトに書き足すのは続かない。スキルは、その手順書を1つのフォルダにまとめて置いておく仕組み。ここは Anthropic が自社の Claude 向けに作った実装を置く場所で、仕組みの取り決めそのもの（Agent Skills の仕様）は別に公開されている、と README の冒頭に断りがある。フォルダには SKILL.md という1枚の文書を置き、先頭に名前と説明、その下に守ってほしい手順を書く。必要なら参考資料やスクリプトを同じフォルダに入れられる。

要になるのは説明文のほう。決まりとして必須の項目は「名前」と「説明」の2つだけで、説明には何をするものかと、どんなときに使うかを書く。Claude は常に手順の全文を読んでいるわけではなく、この説明を見て、当てはまるときに中身を読み込む。実例を見ると、この説明が非常に長い。Word文書を扱うスキルでは「.docx や .dotx への言及」「報告書・メモ・手紙をWordで求められたとき」まで書き並べ、最後に「PDF・表計算・Googleドキュメントには使わない」と使わない場面まで明示している。呼ばれるかどうかがここで決まるので、手順そのものより気を遣う場所だ。

この置き場所には、Anthropic 自身が作った19個の実例が入っている。文書を扱うもの（Word・PDF・PowerPoint・Excel）、作る系（デザイン・配色・アルゴリズムで作る絵）、開発向け（MCPサーバーを作る、Webアプリをテストする、スキル自体を作る）、社内向け（ブランド規定・社内広報）など。ほかに雛形のフォルダがある。仕様書のフォルダもあるが、中身は「仕様は agentskills.io に移した」というリンク1行だけだ。Claude Code からはプラグインの取得先として登録して導入でき、claude.ai の有料プランやAPIからも使える。

同じ依頼を何度も出していて、毎回同じ注意を書き足しているとき

書式、言い回し、社内の決まり。会話のたびに書き足しているものがあるなら、それがそのままスキルの中身になる。書き足す場所を、会話からフォルダに移すという捉え方でいい。

自分でスキルを作る前に、書き方の見本が欲しいとき

説明文をどこまで細かく書くのか、手順をどれくらいの粒度で並べるのか。この置き場所には実例が19個あり、実物を読んで真似できる。うち文書まわりの4つ（Word・PDF・PowerPoint・Excel）については、実際に動いている製品で使われているものだと README が書いている。雛形も同じ場所にある。

ライセンスが2種類ある。 ほとんどのフォルダに LICENSE.txt が置かれていて、たとえば MCPサーバーを作るスキルは Apache-2.0。一方、Word・PDF・PowerPoint・Excel を扱う4つは中身は見られるが自由に使えるものではない扱いで、Anthropic との利用規約に従う旨が書かれている。読んで学ぶのと、自分の製品に取り込むのは別の話だ。リポジトリ全体をまとめて覆うライセンスファイルは置かれていない。

「見本であって製品ではない」と明記されている。 README には、これらは実演と教育のために提供するもので、実際の Claude の挙動とは異なる場合がある、大事な用途に使う前に自分の環境で十分に試すこと、と書かれている。

説明文が甘いと、そもそも呼ばれない。 手順をどれだけ丁寧に書いても、説明に当てはまらなければ読まれない。実例が「使わない場面」まで書いているのは、そのため。うまく動かないときは、手順より先に説明文を疑うのが早い。