Claude の拡張Claude apps and Claude Code

Anthropic / skill-creator

エージェントが実際に読み込むスキルはどう書くのか

難しいのは中身ではありません。いつ読み込まれるかを決める説明文です。

押さえておく点

  1. 説明文が発動条件です。本体より重要です。
  2. スキルに入れるのは手順であり、モデルがすでに知っている一般知識ではありません。
  3. 実際に繰り返した作業から書いてください。でなければ想像上の手順を固定化します。
  4. 予測できない大きなライブラリより、少数の鋭いスキルのほうが機能します。

01実務で何が変わるか

スキルは、適切な瞬間に読み込まれてはじめて役に立ちます。最初の試作の多くはここで失敗します。中身は妥当なのに、説明文が作者の語彙で書かれており、他の人の言い方と噛み合わないからです。

形式を知っているスキルと一緒に作ると、長文の解説を書いてしまうという典型的な失敗も防げます。スキルは判断点を含む手順であって、話題の説明資料ではありません。

02期待に届かない点

その作業を仕組み化すべきかどうかは教えてくれません。その判断は、同じ手順を何度も踏んだ経験からしか出てきません。

スキルが増えすぎること自体も問題になります。説明文が重なると発動が予測不能になり、対処は追加ではなく削除です。

導入と最初の実行

  1. anthropics/skills から Apache 2.0 で導入します。
  2. すでに手作業で 3 回はやった作業から始めます。
  3. 自分が書いたときの言い回しではなく、同僚が使う言い方で説明して発動を試します。

実際によくある質問

確実に発動させるコツは
依頼する人が使う言葉で説明文を書き、想定される言い回しを網羅することです。
スキルに入れてはいけないものは
モデルがすでに知っている一般知識です。スキルは手順、規約、自社固有の事情のためにあります。
何本から多すぎますか
説明文が重なり始めた時点です。発動が予測できなくなったら、統合か削除の合図です。

出典

  1. GitHub の anthropics/skillsrepository
  2. anthropics/skills、skill-creator スキルのディレクトリdocumentation

このページの機械可読版