create-agent-skills

<essential_principles>

スキルの仕組み

スキルは、必要に応じてドメインの専門知識を提供する、モジュール式のファイルシステムベースの機能です。このスキルでは、効果的なスキルの作成方法を説明します。

1. スキルはプロンプトである

プロンプト作成のベストプラクティスがすべて当てはまります。明確に、直接的に、XML 構造を使用してください。Claude は賢いと想定してください。Claude が持っていないコンテキストのみを追加します。

2. SKILL.md は常に読み込まれる

スキルが呼び出されると、Claude は SKILL.md を読み込みます。この保証を活用してください：

• 重要な原則は SKILL.md に記載する（スキップできない）
• ワークフロー固有の内容は workflows/ に記載する
• 再利用可能な知識は references/ に記載する

3. 複雑なスキル向けのルーターパターン

skill-name/
├── SKILL.md              # Router + principles
├── workflows/            # Step-by-step procedures (FOLLOW)
├── references/           # Domain knowledge (READ)
├── templates/            # Output structures (COPY + FILL)
└── scripts/              # Reusable code (EXECUTE)

SKILL.md が「何をしたいですか？」と尋ねる → ワークフローにルーティング → ワークフローが読み込むべき参照先を指定します。

各フォルダーの使いどころ：

• workflows/ - Claude が従う複数ステップの手順
• references/ - Claude がコンテキストとして読むドメイン知識
• templates/ - Claude がコピーして埋める一貫した出力構造（計画、仕様、設定）
• scripts/ - Claude がそのまま実行する実行可能コード（デプロイ、セットアップ、API 呼び出し）

4. 純粋な XML 構造

スキル本文には Markdown 見出し（#, ##, ###）を使用しないでください。セマンティックな XML タグを使用します：

<objective>...</objective>
<process>...</process>
<success_criteria>...</success_criteria>

コンテンツ内の Markdown フォーマット（太字、リスト、コードブロック）は維持してください。

5. 段階的な情報開示

SKILL.md は 500 行未満にしてください。詳細な内容は参照ファイルに分割します。現在のワークフローに必要なものだけを読み込みます。 </essential_principles>

何をしたいですか？

1. 新しいスキルを作成する
2. 既存のスキルを監査／変更する
3. コンポーネント（ワークフロー／リファレンス／テンプレート／スクリプト）を追加する
4. ガイダンスを取得する

続行する前に応答を待ってください。

| 応答 | 次のアクション | ワークフロー | |----------|-------------|----------| | 1、「作成」、「新規」、「構築」 | 尋ねる：「タスク実行スキルですか、ドメイン専門知識スキルですか？」 | 適切な作成ワークフローにルーティング | | 2、「監査」、「変更」、「既存」 | 尋ねる：「スキルのパスは？」 | 適切なワークフローにルーティング | | 3、「追加」、「コンポーネント」 | 尋ねる：「何を追加しますか？（ワークフロー／リファレンス／テンプレート／スクリプト）」 | workflows/add-{type}.md | | 4、「ガイダンス」、「ヘルプ」 | 一般的なガイダンス | workflows/get-guidance.md |

オプション 1（作成）の段階的な情報開示：

• ユーザーが「タスク実行スキル」を選択した場合 → workflows/create-new-skill.md
• ユーザーが「ドメイン専門知識スキル」を選択した場合 → workflows/create-domain-expertise-skill.md

オプション 3（コンポーネントの追加）の段階的な情報開示：

• ユーザーがワークフローを指定した場合 → workflows/add-workflow.md
• ユーザーがリファレンスを指定した場合 → workflows/add-reference.md
• ユーザーがテンプレートを指定した場合 → workflows/add-template.md
• ユーザーがスクリプトを指定した場合 → workflows/add-script.md

意図ベースのルーティング（メニューを選択せずに明確な意図を示した場合）：

• 「このスキルを監査して」、「スキルを確認して」、「レビュー」 → workflows/audit-skill.md
• 「コンテンツを検証して」、「最新か確認して」 → workflows/verify-skill.md
• 「ドメイン専門知識を作成して」、「網羅的なナレッジベース」 → workflows/create-domain-expertise-skill.md
• 「X のスキルを作成して」、「新しいスキルを構築して」 → workflows/create-new-skill.md
• 「ワークフローを追加して」、「リファレンスを追加して」など → workflows/add-{type}.md
• 「ルーターにアップグレードして」 → workflows/upgrade-to-router.md

ワークフローを読んだ後は、それに正確に従ってください。

<quick_reference>

スキル構造クイックリファレンス

シンプルなスキル（単一ファイル）：

---
name: skill-name
description: What it does and when to use it.
---

<objective>What this skill does</objective>
<quick_start>Immediate actionable guidance</quick_start>
<process>Step-by-step procedure</process>
<success_criteria>How to know it worked</success_criteria>

複雑なスキル（ルーターパターン）：

SKILL.md:
  <essential_principles> - Always applies
  <intake> - Question to ask
  <routing> - Maps answers to workflows

workflows/:
  <required_reading> - Which refs to load
  <process> - Steps
  <success_criteria> - Done when...

references/:
  Domain knowledge, patterns, examples

templates/:
  Output structures Claude copies and fills
  (plans, specs, configs, documents)

scripts/:
  Executable code Claude runs as-is
  (deploy, setup, API calls, data processing)

</quick_reference>

<reference_index>

ドメイン知識

すべて references/ にあります：

構造： recommended-structure.md, skill-structure.md 原則： core-principles.md, be-clear-and-direct.md, use-xml-tags.md パターン： common-patterns.md, workflows-and-validation.md アセット： using-templates.md, using-scripts.md 上級： executable-code.md, api-security.md, iteration-and-testing.md </reference_index>

<workflows_index>

ワークフロー

すべて workflows/ 内にあります:

ワークフロー	目的
create-new-skill.md	スキルをゼロから構築する
create-domain-expertise-skill.md	build/ 用の網羅的なドメインナレッジベースを構築する
audit-skill.md	スキルをベストプラクティスに照らして分析する
verify-skill.md	コンテンツが依然として正確かどうかを確認する
add-workflow.md	既存のスキルにワークフローを追加する
add-reference.md	既存のスキルにリファレンスを追加する
add-template.md	既存のスキルにテンプレートを追加する
add-script.md	既存のスキルにスクリプトを追加する
upgrade-to-router.md	シンプルなスキルをルーターパターンに変換する
get-guidance.md	どのような種類のスキルを構築すべきかの判断を支援する
</workflows_index>

<yaml_requirements>

YAML フロントマター

必須フィールド:

---
name: skill-name          # lowercase-with-hyphens, matches directory
description: ...          # What it does AND when to use it (third person)
---

命名規則: create-*、manage-*、setup-*、generate-*、build-* </yaml_requirements>

<success_criteria> 適切に構造化されたスキル:

• 有効な YAML フロントマターを持つ
• 純粋な XML 構造を使用する（本文に Markdown 見出しを含まない）
• 必須の原則を SKILL.md 内にインラインで持つ
• ユーザーの意図に基づいて適切なワークフローへ直接ルーティングする
• SKILL.md を 500 行未満に保つ
• 本当に必要な場合にのみ、最小限の確認質問を行う
• 実際の使用でテスト済みである </success_criteria>