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 / Web (incl. Aspire): aspire-service-defaults, aspire-integration-testing
- Data: efcore-patterns, database-performance
- DI / config: dependency-injection-patterns, microsoft-extensions-configuration
- Testing: testcontainers-integration-tests, playwright-blazor-testing, snapshot-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-web:{aspire-service-defaults,aspire-integration-testing}
|data:{efcore-patterns,database-performance}
|di-config:{dependency-injection-patterns,microsoft-extensions-configuration}
|testing:{testcontainers-integration-tests,playwright-blazor-testing,snapshot-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 / Web（Aspire を含む）
• データ
• DI / 設定
• テスト
• 品質ゲート
• 専門エージェント

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