Claude Skills徹底解剖：プロンプトから実務まで、開発者が分析したAIワークフロー

Claude Skills（AnthropicのAIエージェント機能）の内部構造を逆設計した深掘り分析。Skillsは、複雑なタスクを自動化しながらユーザーのコントロールを維持する実用的アプローチとして、コード実行ではなくプロンプト注入でClaude AIの挙動を変更する。

主な内容:

1. コア概念：Skillsはプロンプトテンプレート

• SkillsはPython/JSのような実行コードを使わず、ドメイン特化の指示（例：PDF処理ガイド）を会話文脈に注入する。
• 通常ツール（Read, Write, Bashなど）とは異なり即時実行されず、Claudeを「準備」させるのを支援する。例：PDF skillを呼び出すと、5,000〜500語の詳細なプロンプトが隠しメッセージとして送信される。

2. メタツールアーキテクチャ

• 「Skill」メタツールがすべての個別Skill（PDF、skill-creatorなど）を管理し、LLMの推論だけでユーザー意図を照合する（埋め込み・分類器は不要）。
• 実行時に2つのメッセージを注入：UIに表示される簡潔なXMLステータス（「PDF skillローディング中」）と、隠れた完全ガイド。

3. SKILL.mdの構造とリソース

• フロントマター（YAML）: name, description（Claude選択シグナル）, allowed-tools（自動承認ツール、セキュリティ考慮）, modelの指定。
• Markdownコンテンツ: ワークフロー、ツール利用順序、出力形式の指示（5,000語以内）。
• 対応ディレクトリ: scripts（自動化スクリプト）、references（参照ドキュメント）、assets（テンプレート/画像、トークン節約）。

4. 実行コンテキストの変更とパターン

• Skill呼び出し時には、ツール権限の自動変更（一時承認）とモデル切替えが可能（contextModifier関数実装）。
• 実践的なパターン：
  • スクリプト自動化: マルチステップの処理スクリプト実行。
  • 読み取り-処理-書き込み: データ変換/整理。
  • 検索-分析-レポート: コードベース分析（Grep活用）。
  • ウィザードワークフロー: ステップごとのユーザー確認。

5. 限界と意義

• 欠点: 並行処理未対応、トークンオーバーヘッド（1,500+）、プロンプト依存。
• 利点: 柔軟性・安全性を重視。「重要な決定は人、反復はAI」という協働モデルを提示。AIエージェントの将来の方向性として、プロンプトベース実装が中核。

（原典: leehanchung.github.io、2025.10.26 公開）