用語集
『Claude Code Skills: 自分専用の AI ワークフローを作る』の用語 49 件。レッスン本文で初出の箇所にホバーすると定義を確認できます。
| 用語 | 定義 | 出典 |
|---|---|---|
| スキル | ディレクトリと SKILL.md ファイルからなる、再利用可能なワークフロー指示のパッケージ。Claude に特定の作業のやり方を伝える。 | Anthropic エンジニアリングブログ: Equipping agents for the real world with Agent Skills |
| SKILL.md | スキルの中核となるファイルで、YAML フロントマター（メタデータ）と Markdown の指示（Claude が従う手順）の 2 部構成になっている。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| YAML フロントマター | SKILL.md の冒頭、トリプルダッシュ (---) で囲まれたメタデータブロックで、name や description といったフィールドを含む。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| name | スキルの一意な識別子を定義する必須フロントマターフィールド。コマンドになるため、小文字・数字・ハイフンのみ使用できる。 | Anthropic エンジニアリングブログ: Equipping agents for the real world with Agent Skills |
| description | スキルが何をするか、いつ使うかを Claude に伝える必須フロントマターフィールド。自動トリガーの唯一の判断材料となる。 | Building skills for Claude, ハンズオン: YAML frontmatter とテスト |
| 自動トリガー | ユーザーの発言がスキルの description と一致したとき、Claude が手動コマンドなしで自分からそのスキルを読み込んで実行すること。 | Building skills for Claude, ハンズオン: YAML frontmatter とテスト |
| 手動呼び出し | /skill-name でスキルを直接呼び出すこと。description のマッチングに頼らず、Claude に強制的に読み込ませる。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| Markdown の指示 | SKILL.md のフロントマター以降すべて。Claude が従う具体的なステップバイステップの手順を Markdown で記述したもの。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| プログレッシブ・ディスクロージャー | すべての詳細を一度に詰め込むのではなく、Claude に今必要なものだけを渡すこと。スキルを短く保ち、読み込みを速くする。 | Anthropic プラットフォームドキュメント: Agent Skills overview |
| サポートファイル | スキルディレクトリ内の SKILL.md 以外のファイル（チェックリスト、設定、スクリプト）。必要に応じて読み込まれ、初期コンテキストを消費しない。 | Anthropic プラットフォームドキュメント: Agent Skills overview |
| パーソナルスキル | ~/.claude/skills/ に保存されるスキル。自分だけが使えるが、すべてのプロジェクトで利用可能。個人的な習慣や汎用ツールに適している。 | Teach Claude Code your workflow: カスタム Skills 実践ガイド |
| プロジェクトスキル | プロジェクトの .claude/skills/ ディレクトリに保存され、Git にコミットされるスキル。チームメイトがリポジトリをクローンすると自動で手に入る。 | Teach Claude Code your workflow: カスタム Skills 実践ガイド |
| 繰り返し性 | スキルに向いている3つの特徴の1つ。同じことを毎日、毎週、時には毎時間行っている。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| 手順が固定 | スキルに向いている3つの特徴の1つ。プロセスが毎回変わるのではなく、明確なステップとして書き出せる。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| 検証できる | スキルに向いている3つの特徴の1つ。Claude が結果を正しく出せたかどうかを判断できる。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| description の公式 | 効果的な description を書くためのガイドライン。何をするか + いつ使うか + 主な機能。 | Building skills for Claude, ハンズオン: YAML frontmatter とテスト |
| トリガーキーワード | description の中でユーザーが実際に言いそうな言葉。Claude はこれをマッチングしてスキルを自動読み込みするか判断する。 | Building skills for Claude, ハンズオン: YAML frontmatter とテスト |
| 入力フォーマット | スキルが受け付ける入力の種類を明記する指示セクション。形状、ソース、具体例を含む。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| 処理ステップ | スキルが実行する順序立てられた具体的な操作。指示の心臓部で、各ステップは曖昧さがないほど具体的であるべき。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| 出力フォーマット | 結果がどう見えるべきかを定義する指示セクション。構造、記号、実例を含む。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| エッジケース | 異常または通常と異なる入力（空入力、不正な形式の入力、過度に長いコンテンツ）で、その扱いを指示で明示的に述べる必要がある。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| テスト方法 | スキルが正しく動作するか検証する手法。直接呼び出す、読み込みの挙動を観察する、テストケースを事前に用意する。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| テストケース | スキルを体系的にテストするために用意した入力と期待出力のペア。本番で頼る前に使用する。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| 反復ループ | スキルが通るテスト→問題発見→修正→再テストのサイクル。「動く」から「うまく動く」への道。 | Claude Code skills: .NET ワークフローと再利用可能なプロンプト |
| A/B で比べる | 同じタスクをスキルありとなしで実行し、両方の時間を測定して、スキルが実際に速く一貫しているかを証明する。 | Claude Code skills: .NET ワークフローと再利用可能なプロンプト |
| チェックリストパターン | 複雑なタスクを一連の明示的なチェック項目として整理すること。各項目は独立して合格または不合格になる。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| 複数ステップのワークフロー | 複雑なタスクを完了するために複数の順次ステップを実行するスキル。あるステップの出力が次のステップに渡されることもある。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| 出力に等級をつける | スキルの所見を深刻度（合格、要検討、要修正）で分け、読者が何を最初に対処すべきか分かるようにする。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| バージョン管理 | プロジェクトスキルを Git で管理し、履歴を見たり、ロールバックしたり、バージョンを比較したりできるようにする。コードと同様。 | Claude Code skills: .NET ワークフローと再利用可能なプロンプト |
| スキルのレビュー | 新規または変更されたスキルをコードレビューと同様にレビューする。description、指示、テストをマージ前に確認する。 | 自己文書化された Runbook としての Claude skills |
| 命名規約 | チーム全体で合意したスキル名のスタイル。ハイフン、動詞-名詞または名詞-動詞の順序、2〜3語。 | Claude Code skills: .NET ワークフローと再利用可能なプロンプト |
| 定期的に整理する | 四半期に一度すべてのスキルをレビューし、ほとんど使われないものを削除または改善する。未使用の山が Claude の選択を妨げないようにする。 | Claude Code skills: .NET ワークフローと再利用可能なプロンプト |
| 変更を通知する | 既存のスキルを変更した後、チームチャンネルに変更とその影響を投稿し、人々が古い前提で新しいスキルを操作して混乱しないようにする。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| スキルを組み合わせる | 複数の単一目的スキルを連鎖させて1つの大きなタスクを処理すること、またはあるスキルの中から別のスキルを参照すること。 | Anthropic エンジニアリングブログ: Equipping agents for the real world with Agent Skills |
| allowed-tools | スキルを指定されたツールセットに制限するオプションのフロントマターフィールド。セキュリティに敏感なケースで権限境界を引く。 | Claude Skills 徹底解説（第一原理の視点） |
| disable-model-invocation | 設定すると Claude による自動読み込みを停止し、手動呼び出しのみを残すオプションのフロントマターフィールド。誤発動を防ぐ。 | Claude Skills 徹底解説（第一原理の視点） |
| model | スキル用に特定のモデルを固定するオプションのフロントマターフィールド。例えばタスクが慎重な推論を必要とする場合に強力な推論モデルを使う。 | Claude Skills 徹底解説（第一原理の視点） |
| MCP サーバー | Claude にツール（データベースアクセス、API 呼び出し）を提供する Model Context Protocol サーバー。スキルはそれらを使うワークフロー知識を提供する。 | The complete guide to building skills for Claude（PDF） |
| コミュニティのスキル | 他の開発者が作成・共有したスキル。GitHub などで見つかる。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| ドキュメント化 | すべてのプロジェクトスキルを使用法と例とともに、プロジェクトの README または .claude/README.md に一覧表示する。 | 自己文書化された Runbook としての Claude skills |
| 単一責任 | 各スキルは1つのことをうまくやるべきで、1つのスキルで複数の無関係な問題を解決しようとすべきではない。 | Anthropic エンジニアリングブログ: Equipping agents for the real world with Agent Skills |
| コンテキスト | Claude がスキルを読み込むとき、SKILL.md の内容がコンテキストウィンドウを占有する。ファイルが長いほど多く消費する。 | Anthropic プラットフォームドキュメント: Agent Skills overview |
| 必要に応じて読み込む | サポートファイルの内容は Claude が実際に必要とするときだけ読まれるため、スキルの初期読み込み時にコンテキストを占有しない。 | Anthropic プラットフォームドキュメント: Agent Skills overview |
| 誤検知 | スキルが正常なコードやコンテンツを問題としてフラグすること。「要確認」カテゴリを追加するか基準を調整して修正する。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| 見逃し | スキルが本来見つけるべき問題を捕捉できないこと。チェックルールを追加するか判断ロジックを調整して修正する。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| 読み込み失敗 | スキルが自動読み込みされない、または手動呼び出しが失敗するとき、ファイルパス、フロントマター形式、name のスペルをこの順でチェックする診断プロセス。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| 具体例 | 入力/出力の例を提供して Claude が期待される挙動を理解できるようにする。実例は散文の説明より多くを伝える。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| フィーチャーブランチ | 実験的なスキルを Git ブランチで作成または変更し、確立されたら main にマージし、チームを混乱させない。 | Claude Code 公式ドキュメント: Extend Claude Code with skills |
| ワークフローの知識 | ステップをどう整理し、どのツールをいつ使い、結果をどう判断するかについての知識。スキルが提供する中核的価値。 | The complete guide to building skills for Claude（PDF） |