本文へ移動
cccskills
無料GitHub で公開

skills-index-snippets

Create and maintain AGENTS.md / CLAUDE.md snippet indexes that route tasks to the correct dotnet-skills skills and agents (including compressed Vercel-style indexes).

インストール方法を見る

含まれるファイル(1)

  • SKILL.md4.5 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Maintaining Skill Index Snippets (AGENTS.md / CLAUDE.md)

When to Use This Skill

Use this skill when:

  • Adding, removing, or renaming any skills or agents in this repository
  • Updating .claude-plugin/plugin.json
  • Creating copy/paste snippets for downstream repositories (OpenCode, Claude Code, etc.)
  • You want a compact, always-on index that improves skill utilization

Goal

Make skills and agents easy for coding assistants to use by removing the decision point.

Instead of hoping an assistant will "remember" to invoke a skill, provide a small router snippet inside AGENTS.md / CLAUDE.md that:

  1. Tells the assistant to prefer retrieval-led reasoning
  2. Provides a task->skill/agent routing index
  3. Defines lightweight quality gates (optional)

Source of Truth

  • Registry: .claude-plugin/plugin.json
    • Skills are listed as directories (each contains SKILL.md)
    • Agents are listed as markdown files in agents/
  • Skill IDs: the name: field in each SKILL.md frontmatter
  • Agent IDs: the name: field in each agent frontmatter

When writing snippets for downstream repos, always reference skills/agents by their IDs (frontmatter name), not by local filesystem paths.

Minimal Snippet Template (Readable)

Use this in target repos to route common tasks:

# 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

Compressed Snippet Template (Vercel-style)

Use this when you want maximum density (small context footprint):

[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}

Regenerating the README block

If the README contains the markers below, the generator can update it automatically:

<!-- BEGIN DOTNET-SKILLS COMPRESSED INDEX -->
...compressed snippet...
<!-- END DOTNET-SKILLS COMPRESSED INDEX -->

Run:

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

How to Update Snippets After Skill Changes

  1. Update .claude-plugin/plugin.json to include/remove skills and agents.
  2. Ensure each skill has correct frontmatter name: (used by OpenCode and others).
  3. Run ./scripts/validate-marketplace.sh.
  4. Update your snippet routing lists:
    • Add new skills to the right category
    • Remove deleted skills
    • Keep names exactly matching frontmatter IDs
  5. If you maintain a downstream AGENTS.md/CLAUDE.md snippet, regenerate it and re-copy into dependent repos.

Recommended Categories

These are snippet categories (not necessarily repository folder structure):

  • C# / code quality
  • ASP.NET Core / Web (incl. Aspire)
  • Data
  • DI / config
  • Testing
  • Quality gates
  • Specialist agents

Keep the snippet small; it should be a router, not documentation.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Patterns for building entity actors with Akka.Hosting - GenericChildPerEntityParent, message extractors, cluster sharding abstraction, akka-reminders, and ITimeProvider. Supports both local testing and clustered production modes.

日本語の概要は準備中です。原文の説明を表示しています。

Aaronontheweb/dotnet-skills1,2212026年10月12日 更新

Configure Akka.NET with .NET Aspire for local development and production deployments. Covers actor system setup, clustering, persistence, Akka.Management integration, and Aspire orchestration patterns.

日本語の概要は準備中です。原文の説明を表示しています。

Aaronontheweb/dotnet-skills1,2212026年10月12日 更新

Critical Akka.NET best practices including EventStream vs DistributedPubSub, supervision strategies, error handling, Props vs DependencyResolver, work distribution patterns, and cluster/local mode abstractions for testability.

日本語の概要は準備中です。原文の説明を表示しています。

Aaronontheweb/dotnet-skills1,2212026年10月12日 更新

Akka.Management for cluster bootstrapping, service discovery (Kubernetes, Azure, Config), health checks, and dynamic cluster formation without static seed nodes.

日本語の概要は準備中です。原文の説明を表示しています。

Aaronontheweb/dotnet-skills1,2212026年10月12日 更新

Write unit and integration tests for Akka.NET actors using modern Akka.Hosting.TestKit patterns. Covers dependency injection, TestProbes, persistence testing, and actor interaction verification. Includes guidance on when to use traditional TestKit.

日本語の概要は準備中です。原文の説明を表示しています。

Aaronontheweb/dotnet-skills1,2212026年10月12日 更新

Guidelines for making .NET libraries and applications trimming-safe and Native AOT compatible. Covers the trimming/AOT model, the MSBuild properties that enable analysis (IsTrimmable, IsAotCompatible, PublishTrimmed, PublishAot), the trimming attributes (RequiresUnreferencedCode, RequiresDynamicCode, DynamicallyAccessedMembers, UnconditionalSuppressMessage), IL2xxx/IL3xxx warning codes, and a pattern playbook: source generators and UnsafeAccessor, generated-interception diagnostic suppressors, intentional runtime scanning boundaries, trimming-safe islands and feature switches, migration analyzers, and temporary warning-approval baselines. Use when introducing trimming/AOT support, resolving IL2xxx/IL3xxx warnings, or making reflection-heavy code trimming-safe in C# / .NET codebases. For System.Text.Json AOT scenarios, see also the serialization skill.

日本語の概要は準備中です。原文の説明を表示しています。

Aaronontheweb/dotnet-skills1,2212026年10月12日 更新

Aaronontheweb のスキルをすべて見る

このスキルの問題を報告する