1. Claude Codeの「Skills」とは
概要: Claude Codeに特定の業務手順を教えるための仕組みです。
仕組み: .claude/skills/ 配下の SKILL.md というファイルに「何をするか(フロントマター)」と「どう動くか(指示)」を記述します。
役割: AIにマニュアルとツールをセットで渡すようなもので、Claudeが自律的にスクリプト(PowerShell/Python等)を実行して業務を完遂できるようにします。
2. 重要な設計思想:Progressive Disclosure(段階的開示)
Skillsの最大の特徴は、必要な情報を必要な時だけ読み込む仕組みにあります。
レベル1: フロントマター(名前と説明)のみを常時読み込み、コンテキスト(AIの記憶容量)を節約。
レベル2: スキル実行時のみ SKILL.md の本文を読み込む。
レベル3: スクリプト本体は実行時のみ呼び出し、結果だけをコンテキストに返す。
これにより、大量のスキルを追加してもAIの回答精度が落ちにくい設計になっています。
3. 実装のポイント
構成の分離: 指示書(SKILL.md)と実行ロジック(scripts/*.pyなど)を分けることで、メンテナンス性を高めています。
フロントマターの設定:
description: Claudeが「どのスキルを使うべきか」を判断する重要なメタデータ。
disable-model-invocation: 自動実行を許可するか、ユーザーの明示的なコマンド(/スキル名)のみにするかを制御。
副作用の制御: データの変換や上書きなど影響が大きい処理は、意図的に自動実行(モデル起動)を無効化する設計を推奨しています。
まとめ
Skillsを活用することで、AI単体では難しい「クラウドサービス操作」「ローカルファイル処理」「ブラウザ操作」を、自然言語による指示だけで安全かつ効率的に自動化できることを示しています。
エンジニアの開発効率化だけでなく、非エンジニアの定型業務の自動化にも大きな可能性を持つ機能です。