skill-builder について
skill-builder は、公式仕様と作成のベストプラクティスに沿った Agent Skills の作成を支援します。目的や範囲の定義からファイル生成、構成の検証、動作テストまでを進めたい作成者向けです。
主な機能
- 01目的、範囲、起動キーワードの明確化
- 02構成と段階的な情報開示の設計
- 03frontmatter 付き SKILL.md の生成
- 04仕様とベストプラクティスに基づく検証
- 05起動と動作のテスト
活用シーン
- 01目的に沿った新しい Agent Skill の作成
- 02スキルのメタデータとファイル構成の確認
- 03代表的なプロンプトによるスキルのテスト
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/skill-builderを入力して読み込まれたか確認します。
同梱ファイルexamples.mdreference.md
詳細
Skill Builder
目的
公式仕様とベストプラクティスに沿って、本番環境で使えるエージェントスキルを作成します。
起動するタイミング
次のような表現があると、自動的に読み込まれます。
- 「build a skill」または「create a skill」
- 「generate a skill」または「make a skill」
- 「design a skill」または「new skill」
信頼できる一次資料（最初に読む）
スキルを作成する前に、次のドキュメントの最新版を読んでください。
- Agent Skills Specification（オープンスタンダード）
https://agentskills.io/specification - Skill Authoring Best Practices（Anthropic）
https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices - Claude Code Skills Documentation（Claude Code 拡張機能）
https://docs.claude.com/en/docs/claude-code/skills - Example Skills（参考実装）
https://github.com/anthropics/skills
これらが正式な基準です。このスキルの内容と矛盾する場合は、公式ドキュメントを優先してください。
実行内容
次の5つのステップでスキルを作成します。
- 明確化 → 目的、範囲、起動キーワードを定義する
- 設計 → 構成を計画し、段階的な情報開示の方法を決める
- 生成 → 適切なフロントマターと本文を含む SKILL.md を作成する
- 検証 → 仕様とベストプラクティスに照らして確認する
- テスト → 起動と動作を検証する
フロントマター（Agent Skills 仕様）
必須フィールドは2つだけです。
---
name: my-skill
description: What this skill does and when to use it. Include specific keywords for discovery.
---
省略可能なフィールド：license、compatibility、metadata、allowed-tools。
Claude Code が追加するフィールド：disable-model-invocation、user-invocable、model、context、agent、hooks、argument-hint。
使用しないでください：version（metadata.versionを使用してください）、auto_activates、priority_score、source_urls、evaluation_criteria、invokes、philosophy、maturity — これらはどのランタイムでも認識されません。
主なベストプラクティス
公式ベストプラクティスより：
簡潔さ
- Claude はすでに十分に賢いため、備えていない情報だけを追加してください。
- すべての段落について、「トークンを消費するだけの価値があるか」を検討してください。
- SKILL.md の本文は500行未満にしてください。
説明の品質
- 三人称で記述してください（「Excel ファイルを処理します」。 「お手伝いします」ではありません）。
- スキルが行うことと、使用するタイミングの両方を含めてください。
- 見つけやすくするため、具体的な起動キーワードを含めてください。
- 最大1024文字です。
段階的な情報開示
- 起動時にメタデータ（名前と説明のみ）が読み込まれます。
- スキルの起動時に SKILL.md が読み込まれます。
- 補助ファイルは必要なときにのみ読み込まれます。
- SKILL.md から参照するファイルは1階層までにしてください。
自由度
- 自由度：高：複数の有効な方法があり、状況に応じて選択できます。
- 自由度：中：推奨パターンがあり、ある程度の変更は許容されます。
- 自由度：低：壊れやすい操作であり、正確な順序が必要です。
時間に左右される内容を含めない
- 「本日時点で」「最近追加された」「v3.0 の新機能」といった表現は使用しないでください。
- 過去の情報が必要な場合は、「古いパターン」セクションを使用してください。
フィードバックループ
- バリデーターを実行 → エラーを修正 → 繰り返す
- 重要な操作には検証手順を含めてください。
検証チェックリスト
✅ フロントマター：name と description があり、有効である
✅ 名前：小文字とハイフンのみ、1～64文字、ディレクトリ名と一致する
✅ 説明：1～1024文字、三人称で、起動キーワードを含む
✅ 本文：500行未満
✅ 参照：SKILL.md から1階層まで
✅ 古い内容がない：時期に関する表現を含まない
✅ 用語の一貫性：概念ごとに用語を統一している
✅ テスト済み：代表的なプロンプトを少なくとも3つ使って動作する
補助ファイル
- reference.md：詳細なパターン、アーキテクチャ、検証ルール
- examples.md：スキル作成のワークフローと例