Claude Code、Skills運用の実践知を公開: 9分類と作り方の注意点

Claude Blog は 2026年6月3日、Claude Code の Skills を Anthropic 内部で使ってきた実践知をまとめた記事を公開しました。Skills を単なる Markdown ではなく、手順、スクリプト、アセット、データを含むエージェント向けの拡張点として扱う内容です。

要点

• Claude Code Skills は、エージェントが発見して使う手順、スクリプト、リソースのフォルダーとして説明されている
• Anthropic 内部の Skills は、ライブラリ参照、検証、データ取得、業務プロセス、雛形生成、コード品質、CI/CD、ランブック、インフラ運用の 9 種に整理されている
• 「当たり前のことを書かない」「つまずきやすい注意点を育てる」「段階的な情報開示を使う」など、実務的な設計指針が示された
• Skills はリポジトリ配置かプラグインマーケットプレイスで配布でき、規模が大きくなるほどマーケットプレイス型が有効になる
• Skills の利用状況をフックで計測し、人気があるものや期待より使われていないものを見つける考え方も紹介された

今回のブログ記事で語られていること

この記事の中心は、Claude Code の Skills を「よく書かれたプロンプト集」ではなく、エージェントが実際に作業品質を上げるための運用資産として扱うことです。記事では、Skills は手順、スクリプト、リソースをまとめたフォルダーであり、Markdown ファイルだけではないと説明されています。Claude Code ではフックなどの設定オプションも使えるため、単に知識を書くだけでなく、検証、作業手順、補助スクリプト、アセット、メモリー的なデータを組み合わせてエージェントの行動を変える設計ができます。

Anthropic が内部 Skills を棚卸しした結果、9 種類の分類が見えたとされています。ライブラリと API の参照情報は、社内ライブラリや SDK の正しい使い方、端のケース、踏みやすい落とし穴をエージェントに教えるものです。プロダクト検証は、Playwright、tmux、外部ツールなどを使い、成果物が本当に動いているかを検証するものです。データ取得と分析は、監視基盤や分析基盤に接続し、正しいダッシュボード、データソース、フィールド名、指標の接頭辞を案内します。業務プロセスとチーム自動化は、スタンドアップ、チケット作成、週次まとめのような繰り返し作業を一つのコマンドに近づけます。

コードの雛形生成とテンプレートは、新しいサービス、マイグレーション、ワークフロー、社内アプリなどを生成するときの社内テンプレートをエージェントに渡すものです。コード品質とレビューは、意地悪な観点でのレビュー、スタイル、テスト実務を明文化し、決定的に動くスクリプトやフックと組み合わせられます。CI/CD とデプロイは、PR の監視、不安定な CI の再実行、デプロイ、ロールバック、チェリーピックのような作業を扱います。ランブックは、アラートやエラーの特徴から調査手順を辿り、レポートを作るものです。インフラ運用は、孤立リソースの削除、依存関係の承認、コスト調査など、破壊的操作を含む運用作業にガードレールを与えます。

作り方の指針も実務的です。記事は、Claude がすでに知っている当たり前のコーディング手順を Skill に書いても価値が低いと指摘します。価値があるのは、通常の推論では外しやすい注意点、社内固有の命名、追記専用テーブルの扱い、API ゲートウェイと課金サービスのリクエスト ID 名の違いのような、失敗しやすい知識です。SKILL.md は入口として使い、詳細な API リファレンス、テンプレート、詰まったジョブの対応などは別ファイルに分ける段階的な情報開示が推奨されています。

Skills の配布については、小さなチームではリポジトリ内の .claude/skills に置く方法が有効ですが、規模が大きくなるとコンテキストへの負荷やセットアップのばらつきが問題になります。その場合、プラグインマーケットプレイスを使い、必要な Skills をチームが選んでインストールできる形が良いとされています。Anthropic では中央チームがすべてを決めるのではなく、まずサンドボックス用フォルダーや Slack で試し、利用が伸びたものをマーケットプレイスに移すような自然発生的な運用が説明されています。

最後に、Skills の計測も重要です。PreToolUse フックで Skills の利用状況をログに残し、どの Skills がよく使われているか、期待より起動されていないものはどれかを見るという考え方が紹介されています。これは、Skills を一度作って終わりにせず、実際のエージェント行動と失敗例を見ながら改善する運用を意味します。

対象になりそうなチーム

• Claude Code を複数リポジトリ、複数チームで標準化したいプラットフォームエンジニアリングチーム
• エージェントの出力品質を検証スクリプト、ランブック、レビュー規則で上げたい開発生産性チーム
• 社内マーケットプレイス、プラグイン、Skill ガバナンスを設計する AI 活用支援チームや開発者体験チーム

今回のブログ記事が関係する人

• anthropic をすでに利用しており、今回の内容が運用、開発、分析、データ連携にどう影響するかを確認したいチーム
• AI・データ基盤の選定や導入計画を進めており、公式ブログの背景や実務上の読み方を整理したい担当者
• セキュリティ、ガバナンス、監査、コスト、サポート体制など、発表内容を本番運用の判断材料に落とし込みたい管理者

実務で確認したいポイント

自社で Skills を作る場合、まず「Claude が普通にやること」ではなく「自社でいつも間違えること」を集めるべきです。コード規約、API の注意点、監視ダッシュボードの対応表、デプロイのロールバック条件、危険なコマンドのガードレールなど、失敗の再発防止に近い内容ほど Skill 化の効果が出ます。

また、Skills は静的な文書ではなく、スクリプト、テンプレート、参照ファイル、ログを含む運用資産として管理する必要があります。GitHub Actions、フック、利用ログとつなぐ場合は、誰が保守するか、どのリポジトリに置くか、どの情報を公開してよいかも決めておく必要があります。

結局、この更新をどう見るべきか

この Claude Blog 記事は、Claude Code Skills を本格的な開発生産性インフラとして扱うための設計メモです。Skills を導入するチームは、単なる便利プロンプトではなく、検証、運用、配布、計測まで含む社内エージェント活用支援の単位として設計するのがよさそうです。

結局、今回のブログ記事をどう読むべきか

このブログ記事は、単独のニュースとして読むだけでなく、対象製品の開発方向、導入支援、運用上の注意点を把握する材料として読むのがよさそうです。