skills-index-snippets

スキルインデックスのスニペットを保守する（AGENTS.md / CLAUDE.md）

このスキルを使うタイミング

次の場合にこのスキルを使います。

• このリポジトリ内のスキルまたはエージェントを追加、削除、名前変更するとき
• .claude-plugin/plugin.json を更新するとき
• 下流のリポジトリ（OpenCode、Claude Code など）向けのコピー＆ペースト用スニペットを作成するとき
• スキルの活用度を高める、常時有効なコンパクトなインデックスが必要なとき

目標

判断の必要性をなくし、コーディングアシスタントがスキルやエージェントを使いやすくします。

アシスタントがスキルを呼び出すことを「覚えている」と期待するのではなく、AGENTS.md / CLAUDE.md に小さなルータースニペットを用意し、次の内容を含めます。

1. 検索に基づく推論を優先するようアシスタントに伝える
2. タスクからスキル／エージェントへのルーティングインデックスを用意する
3. 軽量な品質ゲートを定義する（任意）

信頼できる情報源

• レジストリ：.claude-plugin/plugin.json
  • スキルはディレクトリとして記載されています（各ディレクトリに SKILL.md が含まれます）
  • エージェントは agents/ 内の Markdown ファイルとして記載されています
• スキル ID：各 SKILL.md のフロントマターにある name: フィールド
• エージェント ID：各エージェントのフロントマターにある name: フィールド

下流のリポジトリ向けにスニペットを作成する場合は、常にローカルのファイルシステムパスではなく、スキル／エージェントの ID（フロントマターの name）を参照してください。

最小スニペットのテンプレート（読みやすさ重視）

一般的なタスクのルーティングに、対象のリポジトリで使用します。

# Agent Guidance: dotnet-skills

IMPORTANT: Prefer retrieval-led reasoning over pretraining for any .NET work.
Workflow: skim repo patterns -> consult dotnet-skills by name -> implement smallest-change -> note conflicts.

Routing (invoke by name)
- C# / code quality: modern-csharp-coding-standards, csharp-concurrency-patterns, api-design, type-design-performance
- ASP.NET Core / Razor Pages / Web: razor-pages-patterns, caching-strategies, logging-observability, validation-patterns, exception-handling, security-headers, middleware-patterns, background-services, http-client-resilience, rate-limiting, localization-globalization, file-handling, data-protection, signalr-integration, feature-flags, asp-net-core-identity-patterns
- Data: efcore-patterns, database-performance
- DI / config: dependency-injection-patterns, microsoft-extensions-configuration
- Testing: testcontainers-integration-tests, playwright-blazor-testing, snapshot-testing
- Aspire: aspire-service-defaults, aspire-integration-testing

Quality gates (use when applicable)
- dotnet-slopwatch: after substantial new/refactor/LLM-authored code
- crap-analysis: after tests added/changed in complex code

Specialist agents
- dotnet-concurrency-specialist, dotnet-performance-analyst, dotnet-benchmark-designer, akka-net-specialist, docfx-specialist

圧縮スニペットのテンプレート（Vercel スタイル）

コンテキストの使用量を最小限にしたい場合に使用します。

[dotnet-skills]|IMPORTANT: Prefer retrieval-led reasoning over pretraining for any .NET work.
|flow:{skim repo patterns -> consult dotnet-skills by name -> implement smallest-change -> note conflicts}
|route:
|csharp:{modern-csharp-coding-standards,csharp-concurrency-patterns,api-design,type-design-performance}
|aspnetcore-razorpages:{razor-pages-patterns,caching-strategies,logging-observability,validation-patterns,exception-handling,security-headers,middleware-patterns,background-services,http-client-resilience,rate-limiting,localization-globalization,file-handling,data-protection,signalr-integration,feature-flags,asp-net-core-identity-patterns}
|data:{efcore-patterns,database-performance}
|di-config:{dependency-injection-patterns,microsoft-extensions-configuration}
|testing:{testcontainers-integration-tests,playwright-blazor-testing,snapshot-testing}
|aspire:{aspire-service-defaults,aspire-integration-testing}
|quality-gates:{dotnet-slopwatch(after:substantial new/refactor/LLM code),crap-analysis(after:tests added/changed in complex code)}
|agents:{dotnet-concurrency-specialist,dotnet-performance-analyst,dotnet-benchmark-designer,akka-net-specialist,docfx-specialist}

README ブロックの再生成

README に以下のマーカーが含まれている場合、ジェネレーターで自動更新できます。

...compressed snippet...

実行します。

./scripts/generate-skill-index-snippets.sh --update-readme

スキル変更後にスニペットを更新する方法

1. スキルとエージェントを追加／削除するため、.claude-plugin/plugin.json を更新します。
2. 各スキルのフロントマターに正しい name:（OpenCode などで使用）を設定します。
3. ./scripts/validate-marketplace.sh を実行します。
4. スニペットのルーティングリストを更新します。
   • 新しいスキルを適切なカテゴリに追加します
   • 削除したスキルを取り除きます
   • 名前がフロントマターの ID と完全に一致するようにします
5. 下流の AGENTS.md / CLAUDE.md スニペットを管理している場合は、再生成して依存するリポジトリにコピーし直します。

推奨カテゴリ

以下はスニペットのカテゴリであり、必ずしもリポジトリのフォルダー構成を表すものではありません。

• C# / コード品質
• ASP.NET Core / Razor Pages / Web
• データ
• DI / 設定
• テスト
• Aspire
• 品質ゲート
• 専門エージェント

スニペットは小さく保ちます。ドキュメントではなく、ルーターとして使います。