Skills

概要

Skills let you teach Claude your workflows once and apply them consistently.

Skillsはレシピ（ステップバイステップの手順知識）

MCPだけだと「道具はあるけど使い方がわからない」

Skillsだけだと「知識はあるけど実行手段がない」

ファイル構成

メタデータ (YAML Frontmatter): ファイルの冒頭に記述し、スキルの名前や「どのような時にこのスキルを使うべきか」という説明を記述します。Claudeはこの説明を読んで、実行中にスキルを読み込むべきかどうかを判断します。

指示 (Instructions): タスクを遂行するための具体的な手順、ルール、制約事項を記述します。

scripts/：実行可能コード

references/：補足ドキュメント

assets/：テンプレートやアイコン

code:text

skills/ # 全スキルのルート

└── your-skill-name/ # 個別スキルのディレクトリ

├── SKILL.md # 【必須】スキルの定義とフロントマター

├── scripts/ # 【オプション】実行可能なコード

│ ├── process_data.py # 例：データ処理スクリプト

│ └── validate.sh # 例：整合性チェック用シェル

├── references/ # 【オプション】大規模な参照ドキュメント

│ ├── api-guide.md # 例：APIリファレンス

│ └── examples/ # 例：コード例のディレクトリ

└── assets/ # 【オプション】静的ファイルやテンプレート

└── report-template.md # 例：レポート用テンプレート

[What it does(何をするか)] + [When to use it(いつ使用するか)] + [Key capabilities(主な機能)]

実際のSkills例

設計原則

claudeはこの順番でskills本体を読み込んでいく

第一層（YAMLフロントマター）

常にClaudeのシステムプロンプトに読み込まれます。各スキルがいつ使用されるべきかを知るために必要な情報だけを提供し、すべてをコンテキストに読み込むことはありません。

第二層（SKILL.md本文）

Claudeがスキルが現在のタスクに関連していると考えたときに読み込まれます。完全な指示とガイダンスが含まれています。

第三層（リンクされたファイル）：スキルディレクトリ内にバンドルされた追加ファイルで、Claudeは必要に応じてナビゲートして発見することができます。

YAMLフロントマターが最重要

Claudeがいつそのスキルを使うか判断する根拠がここになる

descriptionに「何をするか」+「いつ使うか」を両方含める。descriptionにトリガーフレーズを入れないとSkillが起動しない

/icons/hr.icon