Skills und Subagenten schreiben

Unsere Position. Wir bauen Skills dort, wo der Agent sich schwertut, nach dem Grundsatz codify actual patterns, not anticipated ones (öffnet in einem neuen Tab). Für Subagenten gilt: Sub-agents exist to fork context, not to specialize (öffnet in einem neuen Tab). Ein Subagent sucht und liest in seinem eigenen Fenster. Er liefert eine knappe Zusammenfassung zurück und hält so den Hauptagenten schlank.

Am Anfang steht die Auswahl. Beim Start stehen von einem Skill nur Name und Beschreibung im Kontext. Die SKILL.md kommt erst dazu, wenn der Skill relevant wird, und gebündelte Dateien laden oder laufen nur bei Bedarf (Anthropic - Skill authoring best practices (öffnet in einem neuen Tab)). Das Budget für die Skill-Liste kürzt lange Beschreibungen und streicht die am wenigsten genutzten zuerst. Der wichtigste Use Case gehört deshalb an den Anfang der Beschreibung (Anthropic - Extend Claude with skills (öffnet in einem neuen Tab)).

Anthropic stellt die Evaluation vor die Instruktionen. Zuerst lasst ihr die Aufgabe ohne Skill laufen und schreibt drei Testszenarien. Dann ergänzt ihr nur so viel Anleitung, wie das Bestehen dieser Szenarien braucht (Anthropic - Skill authoring best practices (öffnet in einem neuen Tab)). Der Gewinn ist real, aber ungleich verteilt. In SkillsBench hoben kuratierte Skills die durchschnittliche Pass Rate von 33,9 % auf 50,5 %. Selbst generierte Skills fielen dagegen unter die Baseline ohne Skills (arXiv - SkillsBench (öffnet in einem neuen Tab)).

Jeder Skill, den das Modell selbst aufruft, belastet den Kontext bei jedem Request. Außerdem driften Skills, wenn die Modelle besser werden. Der Erfinder von Claude Code pflegt etwa sieben Skills und hält 5 bis 10 aktiv gepflegte Skills auf Dauer für tragbar (How Claude Code’s Creator ACTUALLY Automates his work (öffnet in einem neuen Tab)). Löschtests finden die Zeilen, die nichts ändern (Building Great Agent Skills: The Missing Manual (öffnet in einem neuen Tab)).

Ein Subagent entlastet dasselbe Kontextbudget auf anderem Weg (Elite Context Engineering with Claude Code (öffnet in einem neuen Tab)). Der Preis: Die Arbeit hinter der Antwort wird verworfen. Der Hauptagent bekommt die Zusammenfassung, nicht die Suche, aus der sie entstand. Prüft das Ergebnis eines Subagenten deshalb wie jede andere Behauptung, bevor ihr darauf aufbaut (Anthropic - Create custom subagents (öffnet in einem neuen Tab)).

Einstieg

• Skills schreiben: Wie ihr Skills zuschneidet, evaluiert, auslöst, pflegt und absichert, ohne das gemeinsame Kontextfenster zu verschwenden.

Verwandte Seiten

• Skills schreiben: Trigger, Struktur, Ausdünnen und die Debatte über Skill-Evals.
• Ökosystem und Erweiterungsmodell: wie ihr zwischen Skill, Subagent und MCP wählt.
• Context Engineering: der Rahmen aus Reduzieren und Delegieren, dem beide Erweiterungen dienen.
• Kontext als versioniertes Artefakt: wie ein Team viele Skills und Regeln verwaltet.
• Multi-Agent und Orchestrierung: was sich ändert, wenn Subagenten parallel laufen.

Quellen

Dokumentation

• Create custom subagents (öffnet in einem neuen Tab) - Anthropics Claude-Code-Dokumentation dazu, wie ihr Subagenten definiert, welche Tools und welchen Kontext sie bekommen und was der Hauptagent von einem zurückerhält.
• Extend Claude with skills (öffnet in einem neuen Tab) - Anthropics Claude-Code-Dokumentation zu Skills, inklusive des Budgets für die Skill-Liste, das lange Beschreibungen kürzt und die am wenigsten genutzten zuerst streicht.
• Skill authoring best practices (öffnet in einem neuen Tab) - Anthropics Leitfaden zum Schreiben von Agent Skills: schrittweises Laden, Evaluation vor Instruktionen und knappe SKILL.md-Dateien.

Papers und Berichte

• SkillsBench: Benchmarking How Well Agent Skills Work Across Diverse Tasks (öffnet in einem neuen Tab) - Benchmark auf arXiv: Kuratierte Skills heben die Pass Rate von 33,9 auf 50,5 Prozent, selbst generierte Skills fallen unter die Baseline.

Posts

• Codify actual patterns, not anticipated ones (öffnet in einem neuen Tab) - LinkedIn-Post dazu, Skills dort zu bauen, wo der Agent tatsächlich hakt, statt aus erwarteten Bedürfnissen.
• Sub-agents exist to fork context, not to specialize (öffnet in einem neuen Tab) - LinkedIn-Post mit der These, dass ein Subagent für sein eigenes Kontextfenster existiert und eine Zusammenfassung liefert, die den Hauptagenten schlank hält.

Talks und Videos

• Building Great Agent Skills: The Missing Manual (öffnet in einem neuen Tab) - Talk auf der AI Engineer über das Schreiben von Agent Skills, mit Löschtests, die Zeilen ohne Wirkung finden.
• Elite Context Engineering with Claude Code (öffnet in einem neuen Tab) - Video zum Reduzieren und Delegieren von Kontext in Claude Code, inklusive Subagenten, die das Hauptfenster schlank halten.
• How Claude Code’s Creator ACTUALLY Automates his work (öffnet in einem neuen Tab) - Interview-Video mit dem Erfinder von Claude Code über Skills, Loops und Skill Debt, mit der Empfehlung von fünf bis zehn aktiv gepflegten Skills.