Skill-Index-Snippets

Pflege von Skill-Index-Snippets (AGENTS.md / CLAUDE.md)

Wann diese Fähigkeit verwendet werden soll

Verwende diese Fähigkeit bei:

• Hinzufügen, Entfernen oder Umbenennen von Skills oder Agenten in diesem Repository
• Aktualisieren von .claude-plugin/plugin.json
• Erstellen von Kopier-/Einfüge-Snippets für nachgelagerte Repositories (OpenCode, Claude Code, etc.)
• Einem kompakten, stets aktiven Index, der die Skill-Nutzung verbessert

Ziel

Skills und Agenten für Programmierassistenten einfach nutzbar machen, indem die Entscheidungsfindung reduziert wird.

Anstatt darauf zu hoffen, dass ein Assistent sich "erinnert", eine Fähigkeit aufzurufen, wird ein kleiner Router-Snippet in AGENTS.md / CLAUDE.md bereitgestellt, der:

1. Den Assistenten anweist, retrieval-basiertes Denken zu bevorzugen
2. Einen Aufgaben-zu-Skill/Agenten-Routingindex bereitstellt
3. Leichte Qualitätsprüfungen definiert (optional)

Quelle der Wahrheit

• Registry: .claude-plugin/plugin.json
  • Skills werden als Verzeichnisse aufgelistet (jedes enthält SKILL.md)
  • Agenten werden als Markdown-Dateien in agents/ aufgelistet
• Skill-IDs: das name:-Feld in der Frontmatter jeder SKILL.md
• Agenten-IDs: das name:-Feld in der Frontmatter jedes Agenten

Beim Schreiben von Snippets für nachgelagerte Repos immer auf Skills/Agenten anhand ihrer IDs (Frontmatter name) verweisen, nicht auf lokale Dateisystempfade.

Minimal-Snippet-Vorlage (Lesbar)

Verwende dies in Ziel-Repos, um häufige Aufgaben zu routen:

# 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

Komprimierte Snippet-Vorlage (Vercel-Stil)

Verwende dies, wenn maximale Dichte gewünscht wird (kleiner Kontext-Fußabdruck):

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

Den README-Block neu generieren

Wenn das README die folgenden Markierungen enthält, kann der Generator es automatisch aktualisieren:

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

Führe aus:

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

So aktualisierst du Snippets nach Skill-Änderungen

1. Aktualisiere .claude-plugin/plugin.json, um Skills und Agenten aufzunehmen/zu entfernen.
2. Stelle sicher, dass jeder Skill die korrekte Frontmatter name: hat (wird von OpenCode und anderen verwendet).
3. Führe ./scripts/validate-marketplace.sh aus.
4. Aktualisiere deine Snippet-Routing-Listen:
   • Füge neue Skills in die richtige Kategorie ein
   • Entferne gelöschte Skills
   • Die Namen müssen exakt mit den Frontmatter-IDs übereinstimmen
5. Wenn du einen nachgelagerten AGENTS.md/CLAUDE.md-Snippet pflegst, generiere ihn neu und kopiere ihn erneut in die abhängigen Repos.

Empfohlene Kategorien

Dies sind Snippet-Kategorien (nicht unbedingt die Repository-Ordnerstruktur):

• C# / Codequalität
• ASP.NET Core / Web (inkl. Aspire)
• Daten
• DI / Konfiguration
• Tests
• Qualitätsprüfungen
• Spezialagenten

Halte das Snippet klein; es sollte ein Router sein, keine Dokumentation.