Anthropic Claudeスキル構築完全ガイド

Anthropicは、Claude Skillsの構築に関する完全ガイドを公開しました。このスキルシステムは2025年10月にローンチされ、Claude Code、Claude Desktop、およびAPIにおいてClaudeにドメイン固有の能力を付与する主要な方法として急速に普及しました。公式スキルリポジトリ（github.com/anthropics/skills）は2026年5月時点で14万1000以上のスターと1万6000以上のフォークを獲得し、GitHubで最も注目されているAIツールリポジトリの一つとなっています。

スキルの本質

スキルはフォルダであり、その中には必須のSKILL.mdファイルと、オプションでscripts/（実行可能コード）、references/（参照ドキュメント）、assets/（テンプレートやサポートファイル）のサブフォルダが含まれます。スキルはモデルやプラグインではなく、オープンソースのMarkdown命令とサポートファイルです。その強力さは、3層のプログレッシブ・ディスクロージャーシステムにあります。YAMLフロントマター（約100トークン、関連性の判断に使用）、SKILL.md本文（完全な指示とワークフロー）、および参照ファイル（必要に応じて読み込み）から構成され、複数のスキルをインストールしてもコンテキストを圧迫しません。

設計原則には、プログレッシブ開示、コンポーザビリティ（複数スキルの同時読み込み）、ポータビリティ（すべてのサーフェスで同一動作）が含まれます。MCPサーバーとの連携では、MCPがツール接続（「プロフェッショナルなキッチン」）を提供し、スキルがレシピとステップバイステップの指示（「料理の作り方」）を提供します。

スキルの計画

最も一般的な間違いは、ユースケースを定義せずにファイル構造から始めることです。適切なユースケースは、ユーザーが達成したいこと、必要なマルチステップワークフロー、必要なツール、埋め込むべきドメイン知識の4つの質問に答えます。Anthropicは、ドキュメント作成、ワークフロー自動化、MCP拡張の3つのカテゴリを観察しています。成功基準として、定量的指標（90%以上のトリガー率など）と定性的指標（ワークフロー中の修正不要など）を事前に定義することを推奨しています。

技術要件

スキルのファイル構造は厳格です。フォルダ名はケバブケース（小文字とハイフンのみ）、SKILL.mdのファイル名は大文字小文字を正確に、フォルダ内にREADME.mdは不要、スキル名に「claude」や「anthropic」は使用禁止、フロントマターにXML山括弧は使用禁止。YAMLフロントマターには少なくともnameとdescriptionが必要で、descriptionは機能とトリガー条件を含み、1024文字以内。オプションでlicense、compatibility、metadata（author、version、mcp-server）を追加できます。

効果的なスキルの記述

説明フィールドの信頼できるフォーマットは「機能＋使用タイミング＋主要機能」です。例として、Figmaファイル分析、Linearプロジェクト管理、顧客オンボーディングワークフローなどが挙げられます。優れた説明には具体的なタスク、トリガーフレーズ、ファイルタイプを含めます。これらの原則に従うことで、ユーザーは1回のセッションで動作するスキルを構築でき、これはAnthropic公式ガイドの約束でもあります。