Claude実践大全第13章:エージェントスキルで知識を封じ込める──「再現できるベテランの手順」をチームの資産にする

本記事は、『Claude実践大全:Chat・Cowork・Codeで「動くAI」を仕事に組み込む技術』を1章ずつ紹介するシリーズの第13回です。各記事では1つの章のエッセンスをダイジェストでお届けします。

「あの作業、いつもベテランのAさんしかできない」——どの現場にもそんな手順があるはずです。手順書はあっても人によってやり方が少しずつ違い、ミスが起きても各自で直す。この属人化こそ、スケールの敵です。

第13章で扱う「スキル」は、この問題に答えます。前章のCLAUDE.mdがClaudeのあるべき振る舞いを定めるのに対し、スキルはClaudeが何をできるべきか——手順そのもの——を封じ込めます。これがClaudeを、会話相手から「手を動かす実務エージェント」へと変えるのです。

スキルとは「承認済みの手順」を一つにまとめたもの

スキルとは、Claudeが自律的に実行できる、再利用可能な手順的知識のかたまりです。CLAUDE.mdが「セキュリティを優先し、エラー処理を含めること」と方針を語るのに対し、スキルは「このアプリを自動ロールバックつきで安全にデプロイする」という具体的な手順を抱えています。

大事なのは、スキルにはあらかじめ人間が承認した手順・判断ポイント・フォールバックが組み込まれている点です。スキルを呼び出すと、Claudeはその場でやり方をでっち上げるのではなく、レビュー済みの計画どおりに動きます。だから安全で、結果が読めるのです。

💡 ポイント: スキルの段階はさまざま。「このコードをセキュリティの観点で分析する」程度の構造化プロンプトから、APIを呼び外部システムと連携し条件分岐まで行う高度なワークフローまで、必要に応じて育てられます。

SKILL.mdとYAMLフロントマターで「契約」を書く

各スキルは1つのmarkdownファイル(SKILL.md)です。先頭のYAMLフロントマターに、そのスキルが何のためのもので、いつ呼び出すべきか、どんな入力を要し、どんな出力を期待するかを明記します。

この構造が効くのは、必要な入力・実行前の承認・出力の形・成功の判定基準を正確に指定できるからです。ここまで明確なら、呼び出しの自動化も結果の検証も現実的になります。本書では、セキュリティ監査レポートを生成する完全なスキル例をまるごと掲載しています。

自動トリガーで「先回りして」呼び出す

フロントマターの「trigger」フィールドは、Claudeがいつそのスキルを自動で呼び出すかを決めます。開発者が「このコード、セキュリティ的に見てくれる?」と尋ねたとき、Claudeは監査スキルが関連すると気づき、「包括的な監査手順があります。実行しますか?」と返す——これが理想形です。

コツは、エンジニアが普段使う言い回しを先読みすること。正確な言葉でなくても、根底にあるニーズが見えた瞬間に呼び出される。その表現の設計が腕の見せどころです。

⚠ 注意: いくら良いスキルでも、誰かが探さなければ見つからない状態は「配布の失敗」です。スキルは自然言語の示唆かオンボーディングを通じて、自然に発見できる形で届けましょう。

チーム全体でスキルを共有・配布する

よく書かれたスキルが1つあれば、チーム全体の生産性を何倍にも押し上げられます。ただし、それは発見され・信頼され・一貫して使われる場合に限ります。実務でうまくいくのは、バージョン管理された共有リポジトリ(スキルライブラリ)に格納し、READMEで一行説明つきの一覧を用意するパターンです。手順の更新は一元化され、ミスは一度直せば全員に行き渡ります。