Claude Skills構築完全ガイド-Anthropic公式

2026-03-30

整理日: 2026-03-23

基本情報

種類: PDF（公式ガイド、32ページ）
ソース: https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf

核心的な学び

descriptionフィールドがスキルの生死を決める — 「何ができるか」+「いつ使うか」の両方を書く。曖昧な書き方は機能しない
3段階の情報開示 — レベル1（YAMLフロントマター：常時ロード）→ レベル2（SKILL.md本体：関連時）→ レベル3（scripts/references：必要時）でトークン節約
SKILL.md本体は500行以下が推奨 — 超えたらreferences/フォルダに分割
5つの設計パターン — Sequential Workflow、Multi-MCP Coordination、Iterative Refinement、Context-aware Tool Selection、Domain-specific Intelligence
過剰トリガーには「負のトリガー」 — 「〜には使用しないこと」という除外条件をdescriptionに書く

構造図

flowchart TD
    A["descriptionフィールドがスキルの生死を決める"]
    A --> B["3段階の情報開示"]
    B --> C["5つの設計パターン"]
    C --> D["何ができるか"]
    D --> E["負のトリガー"]
    E --> F["SKILL.md本体は500行以下が推奨 — 超えたらr.."]
    style F fill:#c05746,color:#fff,stroke:none

要約

Anthropicが公開したスキル構築の実践書。一番の要点は「descriptionを書けていないスキルは存在しないも同然」という現実で、いつ・どんな場面で使うかをClaudeに伝える文章を丁寧に書くことが出発点。構造面では3段階の情報開示が核心で、常に読まれる部分・必要なときだけ読まれる部分・スクリプトとして実行される部分を意図的に分けることで、文脈ウィンドウを効率的に使える。

kodachanへの適用

既存スキル（/yt-summary, /morning, /reading）のdescriptionに「いつ使うか」のトリガー条件を加筆する
/morningや/readingが長くなりすぎていたらreferences/フォルダに分割
Multi-MCP Coordinationパターン：Calendar + Obsidian + Gmailを横断する/morningはまさにこれ

今週やるアクション

[ ] 既存スキル1つのdescriptionを書き直して起動精度が変わるかテスト

基本情報

核心的な学び

構造図

要約

kodachanへの適用

今週やるアクション

関連ノート