Agenten-Skills: Best Practices für KI-Codierung

Projektübersicht

Agent Skills ist eine produktionsreife Bibliothek mit 20 wiederverwendbaren, auf Markdown basierenden Workflow-Anweisungen, die Best Practices von erfahrenen Ingenieuren in KI-Codierungsagenten kodieren und verhindern, dass diese im gesamten Softwareentwicklungslebenszyklus Abkürzungen nehmen.

Projekt-Hintergrund & Positionierung

Warum es existiert

KI-Codierungsagenten sind fähig, aber undiszipliniert. Ohne Einschränkungen überspringen sie Spezifikationen, lassen Tests aus, ignorieren Sicherheitsüberprüfungen und rationalisieren Abkürzungen mit plausibel klingenden Ausreden. Agent Skills wurde von Addy Osmani – einem Developer Advocate mit tiefen Wurzeln in der Ingenieurkultur von Google – entwickelt, um dieses Problem zu lösen, indem meinungsstarke, überprüfbare Workflows direkt in die Anweisungsebene des Agenten eingebettet werden. Das Projekt behandelt Code als Haftung, nicht als Vermögenswert, und besteht darauf, dass "scheint richtig" niemals ein Ersatz für messbare Beweise ist.

Wie es sich von ähnlichen Projekten unterscheidet

Die meisten Prompt-Bibliotheken sind Ad-hoc-Sammlungen von Tipps. Agent Skills unterscheidet sich auf drei Arten:

Abdeckung des Lebenszyklus — Skills decken jede Phase ab: Definieren → Planen → Erstellen → Verifizieren → Überprüfen → Ausliefern, anstatt nur eine Stufe anzusprechen.
Schutzmechanismen gegen Rationalisierung — Jeder Skill benennt explizit gängige Abkürzungen, die Agenten nehmen, und liefert dokumentierte Gegenargumente, was die Verweigerung schwieriger als die Einhaltung macht.
Werkzeugunabhängige Portabilität — Da jeder Skill reines Markdown ist, läuft er in Claude Code, Cursor, Windsurf, Gemini CLI, GitHub Copilot, Kiro IDE oder jedem Agenten, der einen System-Prompt akzeptiert, ohne Modifikation.

Funktionale Kategorien

📋 Definieren — Spezifikations-Skills · 3 Skills
Repräsentative Beispiele: Systemanforderungen, API-Verträge, Design von Datenmodellen.
Zweck: Agenten zwingen, Anforderungen festzulegen, bevor eine einzige Codezeile geschrieben wird.

🗺 Planen — Architektur & Aufschlüsselungs-Skills · 4 Skills
Repräsentative Beispiele: Aufgabenzerlegung, Architekturplanung, Abhängigkeitsmapping, Zeitschätzung.
Zweck: Sicherstellen, dass Agenten einen überprüfbaren Plan erstellen, anstatt sich direkt in die Implementierung zu stürzen.

🔨 Erstellen — Implementierungs-Skills · 4 Skills
Repräsentative Beispiele: inkrementelle Lieferung, Durchsetzung von Modularität, Codeorganisation, Trunk-Based Branching.
Zweck: Agenten dazu bringen, in kleinen, überprüfbaren Schritten zu erstellen, die jederzeit zusammenführbar bleiben.

✅ Verifizieren — Test-Skills · 4 Skills
Repräsentative Beispiele: Unit-Tests, Integrationstests, Testabdeckungs-Gates, Checkliste für Testmusterreferenzen.
Zweck: Agenten dazu bringen, die Funktionalität mit Tests zu beweisen, anstatt Korrektheit anzunehmen.

🔍 Überprüfen — Qualitäts-Gate-Skills · 3 Skills
Repräsentative Beispiele: Code-Review, Sicherheitsaudit, Performance-Review, Checkliste für Barrierefreiheit.
Zweck: Den gleichen Maßstab anlegen, den ein erfahrener Ingenieur vor der Genehmigung eines Merges verwenden würde.

🚀 Ausliefern — Deployment-Skills · 2 Skills
Repräsentative Beispiele: Checkliste für Produktionsbereitschaft, Deployment-Strategie, Rollback-Planung.
Zweck: Sicherstellen, dass Agenten Observability, Rollback und On-Call-Auswirkungen berücksichtigen, bevor sie in die Produktion gehen.

Kern-Highlights

20 lebenszyklusübergreifende Skills an einem Ort — Von der ersten Spezifikation bis zum Produktions-Deployment hat jede Phase mindestens einen dedizierten Skill mit Schritt-für-Schritt-Verfahren und Verifikations-Gates.

Sieben Slash-Befehle, die Workflow-Phasen zugeordnet sind — /spec, /plan, /build, /test, /review, /code-simplify und /ship geben Teams eine gemeinsame Sprache für die Anweisung von Agenten, unabhängig von der IDE.

Drei spezialisierte Agenten-Personas — Ein Code-Reviewer, Testingenieur und Sicherheitsauditor werden zusammen mit den Skills ausgeliefert, sodass Teams fokussierte Agenten für dedizierte Qualitätsarbeit starten können.

Vier Referenz-Checklisten — Eigenständige, verlinkbare Checklisten für Testmuster, Sicherheitspraktiken, Leistungsoptimierung und Barrierefreiheitsstandards dienen als leichtgewichtige Compliance-Gates.

Verankerung von Ingenieurprinzipien — Skills betten benannte Prinzipien (Hyrum's Law, The Beyonce Rule, Chesterton's Fence) ein, damit Agenten verstehen können, warum eine Praxis existiert, und sie nicht nur mechanisch befolgen.

Erstklassige Multi-Tool-Integration — Dedizierte Konfigurationsverzeichnisse (.claude/, .cursor/, .windsurf/, .gemini/, .opencode/) und Einrichtungsanleitungen für jede Plattform bedeuten null Reibung bei der Einführung in jeder IDE.

Anwendungsfälle nach Rolle

Allgemeine Entwickler
Nutzen Sie die sieben Slash-Befehle als täglichen Workflow-Treiber. Führen Sie /spec aus, bevor Sie mit einer Funktion beginnen, /build während der Implementierung und /review, bevor Sie einen PR öffnen. Die Skills fungieren als erfahrener Ingenieur, der Ihnen über die Schulter schaut, ohne den Planungsaufwand.

DevOps / Plattform-Ingenieure
Konzentrieren Sie sich auf die Ship-Skills und die Checkliste für Produktionsbereitschaft, um sicherzustellen, dass KI-generierter Deployment-Code Rollback-Strategien, Feature-Flags und Observability-Hooks berücksichtigt, bevor Änderungen die Produktion erreichen.

Daten- & Forschungsingenieure
Nutzen Sie die Define- und Plan-Skills, um klare Datenvertrags- und Schemadokumentationen zu erzwingen, bevor Agenten mit der Generierung von Pipeline- oder Transformationscode beginnen. Die Test-Skills helfen bei der Durchsetzung der Abdeckung von Datenqualitätsaussagen.

Produktteams
Nutzen Sie den Spec-Skill als Übersetzungs-Layer für Anforderungen: Füttern Sie Produktbriefings in einen Agenten, der den Spec-Skill ausführt, um strukturierte, entwicklerfertige Anforderungsdokumente zu erhalten, die den Austausch mit der Entwicklung reduzieren.

Schnelleinstieg

🔍 So finden Sie Ressourcen

Durchsuchen Sie das Verzeichnis skills/ im Repository nach allen 20 .md-Skill-Dateien, agents/ für die drei spezialisierten Personas und references/ für die vier eigenständigen Checklisten. Das Verzeichnis docs/ enthält Einrichtungsanleitungen pro Tool.

skills/          # 20 lebenszyklusübergreifende Skills
agents/          # code-reviewer, test-engineer, security-auditor
references/      # testing, security, performance, accessibility
docs/            # setup guides per IDE/tool

🛠 So installieren / integrieren Sie

Option 1 — Claude Code Plugin-Marktplatz (empfohlen)

/plugin marketplace add addyosmani/agent-skills

Option 2 — Lokaler Klon für jedes Tool

git clone https://github.com/addyosmani/agent-skills.git
cd agent-skills

# Claude Code — auf lokales Plugin-Verzeichnis verweisen
claude --plugin-dir ./

# Gemini CLI
gemini skills install https://github.com/addyosmani/agent-skills.git

Option 3 — Einzelne Skills als System-Prompts kopieren

# Verwenden Sie jeden Skill als System-Prompt in jedem Agenten
cat skills/review.md   # in den System-Prompt Ihres Tools einfügen

Cursor / Windsurf / Kiro IDE — Die Verzeichnisse .cursor/, .windsurf/ und .opencode/ enthalten gebrauchsfertige Konfigurationsdateien. Befolgen Sie die Anleitung pro Tool in docs/.

🤝 So tragen Sie bei

git clone https://github.com/addyosmani/agent-skills.git
cd agent-skills

# Erstellen Sie einen neuen Skill nach bestehenden Konventionen
cp skills/review.md skills/my-skill.md
# Bearbeiten Sie my-skill.md — fügen Sie hinzu: Ziel, Schritte, Verifikations-Gates, Anti-Rationalisierungen

# Senden Sie einen Pull Request
git checkout -b feat/my-skill
git add skills/my-skill.md
git commit -m "feat: add my-skill for <purpose>"
git push origin feat/my-skill
# Öffnen Sie PR unter https://github.com/addyosmani/agent-skills/pulls

Projektstruktur

agent-skills/
├── skills/                  # 20 Markdown-Dateien für lebenszyklusübergreifende Skills
│   ├── spec.md              # Anforderungen definieren
│   ├── plan.md              # Arbeit in Aufgaben aufteilen
│   ├── build.md             # Inkrementelle Implementierung
│   ├── test.md              # Verifikations-Workflows
│   ├── review.md            # Qualitäts-Gate vor dem Merge
│   ├── code-simplify.md     # Reduzierung der Komplexität
│   └── ship.md              # Produktions-Deployment-Bereitschaft
├── agents/                  # Spezialisierte Agenten-Personas
│   ├── code-reviewer.md
│   ├── test-engineer.md
│   └── security-auditor.md
├── references/              # Eigenständige Qualitäts-Checklisten
│   ├── testing-patterns.md
│   ├── security.md
│   ├── performance.md
│   └── accessibility.md
├── .claude/commands/        # Claude Code Slash-Command-Integration
├── .gemini/commands/        # Gemini CLI Integration
├── .cursor/                 # Cursor IDE Konfiguration
├── .windsurf/               # Windsurf IDE Konfiguration
├── .opencode/               # Kiro / OpenCode IDE Konfiguration
├── docs/                    # Einrichtungsanleitungen pro Tool
└── README.md                # Projektübersicht und Schnelleinstieg

Lizenz

MIT-Lizenz


✅ Erlaubt	Nutzung in persönlichen, Open-Source- und kommerziellen Projekten
✅ Erlaubt	Forken, Modifizieren und Weiterverbreiten mit Namensnennung
✅ Erlaubt	Bündeln von Skills in proprietären KI-Produkten oder SaaS-Tools
❌ Verboten	Entfernen des Copyright-Hinweises aus weiterverbreiteten Kopien
ℹ️ Hinweis	Keine Garantie; Mitwirkende haften nicht für Ergebnisse der Produktionsnutzung

FAQ

F: Benötige ich speziell Claude Code, oder funktioniert jedes KI-Codierungstool?
A: Jedes Tool, das Markdown als System-Prompt akzeptiert, funktioniert. Alle 20 Skills sind reine .md-Dateien. Claude Code ist die primäre Integration mit der reichhaltigsten Benutzererfahrung (Slash-Befehle, Plugin-Marktplatz), aber Cursor, Windsurf, Gemini CLI, GitHub Copilot und jeder generische Agent funktionieren genauso gut.

F: Was unterscheidet einen "Skill" vom bloßen Einfügen eines Prompts?
A: Jeder Skill ist ein strukturierter Workflow, keine Einmalanweisung. Er enthält ein explizites Ziel, nummerierte Schritte mit Verifikations-Gates in jeder Phase und einen Abschnitt "Anti-Rationalisierungen", der die Abkürzungen, die Agenten häufig nehmen, vorwegnimmt und widerlegt. Dies macht den Skill deutlich robuster als einen einfachen Prompt.

F: Kann ich die internen Konventionen meines Teams zu einem Skill hinzufügen?
A: Ja – und das ist der empfohlene Workflow. Forken Sie das Repository, bearbeiten Sie die relevanten .md-Dateien, um die spezifischen Standards Ihres Teams einzufügen (z. B. interne Test-Frameworks, Deployment-Checklisten), und verweisen Sie Ihre Agenten auf Ihren Fork. Das Markdown-Format wurde speziell für einfache Anpassungen gewählt.

F: Verlangsamt dies KI-Codierungsagenten erheblich?
A: Die Skills fügen Schritte hinzu, aber sie verhindern die weitaus kostspieligere Nacharbeit, die auf undisziplinierte Generierung folgt. Das Projekt behandelt dies als einen bewussten Kompromiss: langsamere anfängliche Ausgabe, weitaus weniger Fehler, die zur Überprüfung oder Produktion gelangen.

F: Wie unterscheiden sich die drei spezialisierten Personas von den 20 Skills?
A: Skills sind Workflow-Anweisungen – sie sagen einem Agenten, wie er eine Aufgabe ausführen soll. Personas (agents/) konfigurieren die Identität und Prioritäten eines Agenten für fokussierte Arbeit (z. B. immer wie ein Sicherheitsauditor denken). Sie ergänzen sich: Sie können den Security-Audit-Skill mit der Security-Auditor-Persona anwenden, um das gründlichste Ergebnis zu erzielen.

Schnelle Links

Ressource	URL
GitHub Repository	https://github.com/addyosmani/agent-skills
Plugin Marketplace (Claude Code)	`/plugin marketplace add addyosmani/agent-skills`
Issues & Diskussionen	https://github.com/addyosmani/agent-skills/issues
Releases	https://github.com/addyosmani/agent-skills/releases
Autor	https://github.com/addyosmani

Zusammenfassung

Agent Skills ist ein seltenes Open-Source-Projekt, das ein strukturelles Problem und keine Funktionslücke löst: Es lässt KI-Codierungsagenten wie disziplinierte erfahrene Ingenieure agieren, anstatt wie übermäßig selbstbewusste Junioren. Mit über 25.000 GitHub-Sternen, erstklassiger Unterstützung für jede wichtige KI-Codierungsplattform und einer MIT-Lizenz ist es sofort nutzbar für jedes Team, das KI bereits in seinem Entwicklungs-Workflow einsetzt. Entwickler, die konsistente, überprüfbare, produktionsreife Ergebnisse von ihren KI-Codierungswerkzeugen wünschen, sollten Agent Skills als erste Schicht ihrer Agentenkonfiguration in Betracht ziehen.

agent-skills