Agent Skills: Ingenieursdisziplin für Coding-Agenten

Alles Wissenswerte über addyosmani/agent-skills: eine Sammlung überprüfbarer Workflows, die versucht, Spezifikation, Tests, Review und Auslieferung in die Arbeit von Coding-Agenten einzubauen.

Was Agent Skills ist

Agent Skills ist eine Bibliothek von Ingenieurs-Skills für Coding-Agenten. Jeder Skill ist ein Markdown-Dokument mit Metadaten und einem Prozess: Schritte, Kontrollpunkte, Warnsignale, Antworten auf Rationalisierungen und eine überprüfbare Austrittsbedingung. Es ist kein Modell und keine Ausführungsplattform.

Der Ansatz geht davon aus, dass ein Agent meist direkt von einer Anfrage zu einer Implementierung springt und dabei weniger sichtbare Aufgaben überspringt: Anforderungen präzisieren, entwerfen, vor der Implementierung testen, überprüfen und die Auslieferung vorbereiten. Das Repository verpackt diese Schritte in 24 Skills: 23 für den Entwicklungszyklus sowie using-agent-skills, das entscheidet, welcher Ablauf angewendet wird.

Das README strukturiert den Weg als definieren → planen → bauen → verifizieren → überprüfen → ausliefern. Neben den Skills bietet es vier Review-Profile —Code, Tests, Sicherheit und Web-Performance— sowie Referenzmaterial zu Sicherheit, Barrierefreiheit, Performance und Observability.

Leuchtendes digitales Dokument mit Metadaten, Häkchen und Warnsymbolen, das eine Skill als strukturierte Markdown-Datei darstellt.

Der Ursprung: von einem im Februar erstellten Repository zu einer öffentlichen Erklärung im Mai

Die GitHub-API verortet die Erstellung des Repositorys auf den 15. Februar 2026; der früheste auffindbare Commit seiner Historie, Add AGENTS.md, stammt vom selben Tag und ist von Addy Osmani signiert. Das GitHub-Konto weist Osmani als ehemaligen Google-Direktor aus, der an Gemini und Google Cloud gearbeitet hat; diese Biografie stammt vom Konto selbst, nicht von einer institutionellen Zuordnung des Projekts zu Google.

Futuristische Zeitleiste mit den Daten 15. Februar und 3. Mai über einem Netzwerk aus Knoten, das das Wachstum des Repositorys auf 27.000 Sterne darstellt.

Osmani veröffentlichte den Launch-Artikel „Agent Skills” am 3. Mai 2026. Darin berichtet er, dass das Projekt die 27.000-Sterne-Marke überschritten hatte, und formuliert das Ausgangsproblem: Agenten optimieren auf das Signal „Aufgabe erledigt”, während zuverlässige Ingenieursarbeit auch Spezifikationen, Tests, Belege und Review verlangt. Seine Antwort ist nicht, umfangreiche Dokumentation in den Kontext zu laden, sondern dem Agenten eine kurze Sequenz zu geben, die er ausführen und überprüfen kann.

Die Spannung zu nativen Funktionen wird explizit benannt: Eine Regeldatei oder eine allgemeine Erklärung garantiert nicht, dass der Agent die Praxis anwendet, wenn es darauf ankommt. Agent Skills nutzt einen Router-Skill, um den relevanten Ablauf schrittweise zu laden, statt den gesamten Katalog von Anfang an bereitzustellen. Für Claude Code dokumentiert das Repository außerdem einen Session-Start-Hook, der using-agent-skills einspeist; dessen Test prüft den JSON-Inhalt sowohl mit jq als auch ohne diese verfügbare Hilfsanwendung.

Philosophie und Prinzipien

Osmanis Text und das README stützen sich auf fünf überprüfbare Designentscheidungen:

Prozess vor Prosa: Ein Skill muss konkrete Handlungen ordnen, statt sich auf die Beschreibung guter Praktiken zu beschränken.
Antirationalisierung: Tabellen erfassen Ausreden zum Überspringen von Schritten und ihre Widerlegung, weil Modelle plausibel klingende Abkürzungen rechtfertigen können.
Nicht verhandelbare Verifizierung: Ein Test, eine Build-Ausgabe, ein Trace oder ein Review gelten als Beleg; eine Aussage, dass etwas „richtig aussieht”, schließt die Aufgabe nicht ab.
Progressive Offenlegung: Es wird der für die aktuelle Phase nötige Kontext aktiviert, nicht das gesamte Material gleichzeitig.
Umfangsdisziplin: Der Agent sollte benachbarte Systeme nicht refaktorieren oder eine Aufgabe ausweiten, ohne die Änderung zu verstehen und zu begründen.

Der Autor bringt diese Ideen mit von Google veröffentlichten Ingenieurspraktiken in Verbindung —etwa Hyrums Gesetz, Lesbarkeitsprüfung, Tests und schrittweise Rollouts—, doch die Quelle stellt dies als Inspiration und Adaption des Projekts dar, nicht als offizielle Google-Dokumentation.

KI-Kern, geschützt durch holografische Schilde, die geisterhafte Ausreden abwehren und das Prinzip der Antirationalisierung darstellen.

Wie es funktioniert

Der Ablauf lässt sich über acht Slash-Befehle aufrufen:

Ziel	Befehl	Angegebenes Prinzip
Definieren, was gebaut wird	`/spec`	Spezifikation vor Code
Arbeit zerlegen	`/plan`	Kleine, atomare Aufgaben
Implementieren	`/build`	Ein vertikaler Abschnitt nach dem anderen
Beweisen, dass es funktioniert	`/test`	Tests sind Belege
Vor dem Merge überprüfen	`/review`	Codequalität verbessern
Web-Performance auditieren	`/webperf`	Vor der Optimierung messen
Vereinfachen	`/code-simplify`	Klarheit vor Cleverness
Auslieferung vorbereiten	`/ship`	Schneller ist sicherer

Futuristisches Kommandozentrum mit den acht Slash-Befehlen des Ablaufs, von /spec bis /ship, angeordnet in einer kreisförmigen Oberfläche.

/build kann den Plan erzeugen und dessen Aufgaben nach einer einzigen Freigabe ausführen: Jede Aufgabe behält testgetriebene Entwicklung und einen eigenen Commit bei, und der Prozess stoppt bei Fehlern oder riskanten Schritten. Skills werden zudem kontextabhängig aktiviert: Das README nennt API-Design und Interface-Arbeit als Beispiele.

Die allgemeine Installation nutzt das offene Werkzeug skills:

npx skills add addyosmani/agent-skills
npx skills add addyosmani/agent-skills --list
npx skills add addyosmani/agent-skills --skill code-review-and-quality

Terminal, das den Befehl npx skills add addyosmani/agent-skills ausführt und strukturierte Markdown-Dateien abruft.

Das README behauptet, dieses Werkzeug sei mit mehr als 70 Agenten kompatibel, und listet unter anderem Claude Code, Cursor, Codex, Copilot, Cline und Gemini auf. Es enthält außerdem spezifische Integrationen und Verzeichnisse für Claude Code, Codex, Gemini, Antigravity und OpenCode. Das ist vom Projekt dokumentierte Kompatibilität; sie entspricht keiner Zertifizierung durch die jeweiligen Anbieter.

Offizieller und halboffizieller Status

Das Repository enthält ein Marketplace-Manifest, und Osmanis Artikel dokumentiert für Claude Code die Befehle /plugin marketplace add addyosmani/agent-skills und /plugin install agent-skills@addy-agent-skills. Das belegt einen Installationsmechanismus über den vom Projekt selbst konfigurierten Marketplace.

In den konsultierten Quellen wurde weder eine Anbieterseite gefunden, die Agent Skills in einen offiziellen Marketplace aufnimmt, noch eine Ankündigung von Anthropic, OpenAI, Google, Cursor oder einem anderen Unternehmen, das es befürwortet. Sein überprüfbarer Status ist daher community-getragen oder halboffiziell durch seine nativen Integrationen, keine offizielle Anbieterbestätigung. Die 81.424 Sterne und der Hacker-News-Thread zeigen eine bemerkenswerte Verbreitung, stellen aber keine formale Auszeichnung als De-facto-Standard dar.

Das Ökosystem

Ökosystemkarte mit einem zentralen Monolithen, der das Hauptrepository darstellt, umgeben von Satellitenknoten und einer Sternenkonstellation.

Repositories, Adapter und verwandte Werkzeuge

addyosmani/agent-skills vereint die Adapter des Projekts: .claude-plugin, .codex-plugin, .gemini, .opencode, .agents/plugins und commands. Das sind keine separaten Repositories, sondern Formate und Integrationen innerhalb des Hauptrepositorys.
agentskills/ wird vom Hacker-News-Nutzer kergonath als offizielles Repository des Skills-Ökosystems genannt. Die abgerufene Konversation erlaubt es nicht, seine genaue technische Beziehung zu Agent Skills zu bestimmen, weshalb ihm weder Integration noch direkte Konkurrenz zugeschrieben wird.
obra/superpowers und die Skills von Matt Pocock sind die beiden Sammlungen, die das eigene Vergleichsdokument von Agent Skills als nächstliegende Referenzen nennt. Die erste bevorzugt autonome Läufe mit Subagenten, einen strikten Prozess und Isolation mittels Worktrees; die zweite wird als kuratiertes Werkzeug-Set für Claude Code mit einer charakteristischen Nachfrage-Schleife beschrieben. Diese Beziehung stammt aus dem Repository selbst, nicht aus einer Zugehörigkeit.

Forks und Übersetzungen

Die GitHub-Fork-API lieferte unter den sternereichsten Dev-moe-kyawaung/agent-skills (17), rosnjs/agent-skills (5) und wizzeart/agent-skills (2). Ihre Beschreibungen wiederholen die Beschreibung des Originalprojekts; sie werden daher als Forks eingestuft, nicht als eigenständige Ports oder Erweiterungen.

Bei den durchgeführten Abfragen wurde keine überprüfbare Community-Übersetzung identifiziert. Zudem legt CONTRIBUTING.md fest, dass das Projekt keine Übersetzungen von Dokumentation oder Skills annimmt, um zu verhindern, dass sie veralten. Diese Richtlinie beweist nicht, dass keine externen Übersetzungen existieren; sie erklärt nur, dass sie nicht Teil des Hauptrepositorys sind.

Die öffentlichen Repositories von addyosmani wurden abgefragt, um Schwesterprojekte aufzuspüren. Mit den abgerufenen Quellen wurde kein Schwester-Repository festgestellt, das speziell Agent Skills, Evaluierungen oder einem separaten Marketplace gewidmet ist; diese Beziehung wird hier nicht erfunden.

Zahlen zum Repository

Messung: 3. August 2026, GitHub-API und -Seite.

Metrik	Wert
Sterne	81.424
Forks	8.775
Abonnenten	440
Commits	383
Von der API angegebene offene Issues	145
Branches	12
Tags	7
Hauptsprache	JavaScript
Lizenz	MIT
Erstellung	15. Februar 2026
Letzter auffindbarer Commit	26. Juli 2026
Letzte Veröffentlichung	`0.6.5`, 26. Juli 2026

Die von der API zurückgegebenen Hauptbeitragenden nach Anzahl der Beiträge waren addyosmani (218), nucliweb (33), federicobartoli (33), dj2313 (6), Dashsoap (4) und Keerthi-Sreenivas (4). Die Zahl von 383 Commits wurde mit der Hauptseite und der letzten auffindbaren Seite der Commit-Paginierung abgeglichen.

GitHub gibt watchers_count mit demselben Wert wie die Sterne zurück; deshalb wird hier subscribers_count als tatsächliche Abonnentenzahl angegeben. Das Feld open_issues_count kann offene Pull Requests einschließen, sodass 145 nicht zwangsläufig nur Issues zählt. Die API gab updated_at mit dem 3. August 2026 zurück, was mit dem Messdatum übereinstimmt; es wird als Metadatum wiedergegeben, nicht als Schlussfolgerung über zusätzliche Aktivität.

Wie man beiträgt

CONTRIBUTING.md bittet darum, vorab den Katalog und offene Pull Requests zu prüfen, die Anatomie eines Skills zu lesen und im Vorschlag die Lücke zu begründen, die geschlossen werden soll. Bei Überschneidungen soll der bestehende Skill erweitert statt ein weiteres Verzeichnis angelegt werden.

Ein neuer Skill benötigt ein Verzeichnis mit kleingeschriebenem, bindestrichgetrenntem Namen, eine SKILL.md mit den Metadaten name und description sowie einen Fall in evals/cases/<name>.json: mindestens drei positive Auslöser, zwei negative und eine Verhaltensevaluierung. Ausführungsevaluierungen müssen echte Dateien aus evals/fixtures/ verwenden; konversationelle Skills können eine von einer Person überprüfte Dialogevaluierung nutzen. Die kontinuierliche Integration setzt diese Anforderungen durch.

Futuristische Werkstation, die ein neues Skill-Verzeichnis zusammenbaut, neben einer Checkliste mit Beitragsanforderungen.

Für Änderungen am Start-Hook oder am Router-Skill verlangt der Leitfaden die Ausführung von:

bash hooks/session-start-test.sh

Der Beitrag wird unter MIT lizenziert. Der Leitfaden begrenzt zudem den Umfang: fokussierte Änderungen, Beibehaltung von Struktur und Ton sowie die Überprüfung, dass die YAML-Metadaten gültig bleiben.

Wie die Community reagierte

Die wichtigste abgerufene Konversation ist der Hacker-News-Thread 48015397, veröffentlicht von BOOSTERHIDROGEN am 4. Mai 2026. Sein Wurzelelement in der Algolia-API verzeichnet 376 Punkte und 212 Kommentare.

Abstrakte Visualisierung eines Hacker-News-Threads mit Gesprächsblasen, verbunden durch leuchtende Glasfaserfäden.

encoderer schrieb, mehrere Skills übernommen zu haben, und hob die für API-Design und Interface-Tests als besonders nützlich hervor. Das ist konkretes Lob für zwei Bereiche, keine vergleichende Bewertung.
ElijahLynn erklärte, es in einem neuen persönlichen Projekt zu nutzen und sich dadurch auf Architektur und Produktdesign konzentrieren zu können, statt zu entscheiden, wie jeder einzelne Teil gebaut wird; zudem dankte er dem Repository und seinen Mitwirkenden.
y-curious sagte, viele Ideen mitzunehmen, äußerte aber Bedenken hinsichtlich der Möglichkeit, das Plugin zu deinstallieren, und vertrat die Ansicht, jeder Skill sollte für den Entwickler personalisiert werden. bvirkler entgegnete, ein Plugin sei nur eine Reihe von Dateien, und fragte, warum es sich nicht löschen ließe; die Quelle bewahrt den Zweifel, keine abschließende technische Klärung.
kergonath berichtete, die meisten eigenen Skills selbst entwickeln zu müssen, und dass Claude ihm dabei nicht besonders geholfen habe. Das ist Kritik an der Unterstützung des Agenten bei dieser Aufgabe, kein Vorwurf eines Fehlers im Repository.

Zudem tauchte eine frühere Einreichung auf, 47670950, von msolujic, mit 2 Punkten und 0 Kommentaren. Sie dient als Beleg früher Entdeckung, nicht als Zustimmung oder Kritik der Community.

Agent Skills im Vergleich zu anderen Ansätzen

Ansatz	Überprüfbare Übereinstimmung	Überprüfbarer Unterschied laut `docs/comparison.md`
`obra/superpowers`	Eine Sammlung von Skills für Coding-Agenten.	Fokussiert auf autonome Läufe mit Reasoning, Subagenten, einen strikten Prozess und Isolation mittels Worktrees; Agent Skills ordnet den gesamten Zyklus nach Phasen und fügt Review-Profile und Evaluierungen im Repository hinzu.
Matt Pococks Skills	Eine Sammlung von Workflows für Coding-Agenten.	Wird als kuratiertes, meinungsstarkes Werkzeug für Claude Code mit einer Nachfrage-Schleife präsentiert; Agent Skills verteilt seinen Katalog über die sechs Phasen des Entwicklungszyklus.

Der Vergleich selbst warnt davor, eines der beiden abstrakt als „besser” zu bezeichnen. Der Kontrast beschränkt sich darauf, wie der Autor die Projekte charakterisiert; es wurde keine unabhängige Bewertung gefunden, die Ergebnisse, Kosten oder Qualität zwischen ihnen misst.

Anwendungsfälle und wem dieses Repository helfen kann

Teams, die verhindern wollen, dass ein Agent direkt von einer Anfrage zu einer Codeänderung springt, können die Sequenz /spec → /plan → /build → /test → /review → /ship nutzen, um Spezifikation, Belege und Review sichtbar zu machen.
Verantwortliche für API-, Interface- oder Sicherheitsänderungen können spezialisierte Skills wie api-and-interface-design, frontend-ui-engineering und security-and-hardening aktivieren, statt sich auf eine allgemeine, nicht überprüfbare Richtlinie zu verlassen.
Betreuer eines internen Workflows für Agenten können die vom Repository geforderte Anatomie —Prozess, Rationalisierungen, Warnsignale und Austrittsbedingung— sowie dessen Evaluierungsfälle übernehmen, um zu prüfen, ob sich ein Skill wie erwartet aktiviert und verhält.
Personen, die mit mehreren Agentenumgebungen arbeiten, können das Set mit npx skills installieren oder die dokumentierten Adapter für Claude Code, Codex, Gemini, Antigravity oder OpenCode nutzen; vorab lohnt sich eine Prüfung des Verhaltens in der eigenen Umgebung, da die angegebene Kompatibilität keine Anbieterzertifizierung ist.

Ressourcen

Repository: https://github.com/addyosmani/agent-skills
Dokumentation und Installation: https://github.com/addyosmani/agent-skills#quick-start
Ankündigung und Philosophie des Autors: https://addyosmani.com/blog/agent-skills/
Offizielle Skills: https://github.com/addyosmani/agent-skills/tree/main/skills
Beitragsleitfaden und Evaluierungen: https://github.com/addyosmani/agent-skills/blob/main/CONTRIBUTING.md und https://github.com/addyosmani/agent-skills/tree/main/evals
Vergleich mit verwandten Ansätzen: https://github.com/addyosmani/agent-skills/blob/main/docs/comparison.md
Community und Rezensionen: https://news.ycombinator.com/item?id=48015397 und https://news.ycombinator.com/item?id=47670950
Discord: In den konsultierten Quellen wurde kein offizieller Discord-Link gefunden.

Hinweis: Dieser Artikel kombiniert das README, den Beitragsleitfaden, das Vergleichsdokument und den Launch-Artikel von Agent Skills; die GitHub-API und -Seite; sowie Hacker News über Algolia, abgerufen am 3. August 2026. Zahlen ändern sich mit der Zeit.