Agent Skills: Senior-Engineer-Disziplin für AI-Coding-Agenten

Addy Osmanis Open-Source-Projekt Agent Skills hat über 26.000 GitHub-Sterne erreicht - und das aus gutem Grund. Es adressiert ein fundamentales Problem: AI-Coding-Agenten nehmen standardmäßig den kürzesten Weg zu “fertig”, überspringen dabei aber die unsichtbare Arbeit, die Senior Engineers von Junior Engineers unterscheidet.

Das Kernproblem: Wenn du einen AI-Agenten bittest, ein Feature zu implementieren, schreibt er das Feature. Er fragt nicht nach Specs, schreibt keine Tests vor der Implementierung, prüft keine Trust Boundaries, und überlegt nicht, wie der PR einem Reviewer erscheinen wird. Er produziert Code und erklärt sich für fertig.

Was Agents überspringen: Specs schreiben. Tests VOR der Implementation erstellen. Arbeit in reviewbare Chunks aufteilen. Das langweilige Design wählen. Beweise hinterlassen, dass das Ergebnis korrekt ist. Änderungen so dimensionieren, dass ein Mensch sie tatsächlich reviewen kann.

Die Design-Wahl - Process over Prose: Ein Skill ist keine Referenz-Dokumentation. Er ist ein Workflow: eine Sequenz von Schritten mit Checkpoints und Exit-Kriterien. Ein 2.000-Wörter-Essay über Best Practices? Der Agent liest es und überspringt das eigentliche Testen. Ein Workflow? Der Agent hat etwas zu tun, und du hast etwas zu verifizieren.

Anti-Rationalisierungs-Tabellen: Das innovativste Feature sind vorformulierte Gegenargumente auf typische Ausreden. “Diese Aufgabe ist zu einfach für einen Spec” → Akzeptanzkriterien gelten trotzdem. “Ich schreibe die Tests später” → Später existiert nicht. Schreibe den fehlschlagenden Test zuerst.

Der SDLC hinter den Skills: 20 Skills organisieren sich um sechs Lebenszyklus-Phasen: Define, Plan, Build, Verify, Review, Ship. Das ist der gleiche Zyklus, den jedes funktionierende Engineering-Team nutzt - nur dass AI-Agenten diese Phasen standardmäßig überspringen.

Für alle, die AI-Coding-Agenten produktiv einsetzen wollen, ist Agent Skills ein Must-Have. Es zwingt den Agenten durch die gleichen Phasen, die ein Senior Engineer durchläuft - weil Code ohne diese Phasen Incidents produziert.

Link zum Original: Agent Skills