Skills - Echte Engineering-Skills für KI-Agenten

1. Projektübersicht

Skills (von Matt Pocock) ist eine Open-Source-Sammlung von KI-Agenten-"Skills" — wiederverwendbare, zusammensetzbare Anweisungssätze, die Coding-Agenten wie Claude Code und Codex disziplinierte, praxisnahe Softwareentwicklungspraktiken beibringen, anstatt schnelle, aber unzuverlässige Codegenerierung.

2. Hintergrund & Positionierung

Skills wurde entwickelt, um vier wiederkehrende Fehlermuster zu beheben, auf die Entwickler bei der Arbeit mit KI-Coding-Agenten stoßen:

Missverhältnis zwischen Entwicklerabsicht und Agentenausgabe — abgemildert durch strukturierte Interview-Skills wie grill-me und grill-with-docs.
Geschwätzigkeit des Agenten, die die Projektklarheit verschleiert — adressiert durch eine gemeinsame Domänensprache und eine CONTEXT.md-Konvention, die Agenten in der Projektterminologie verankert.
Fehlerhafter Code durch schwache Feedback-Schleifen — angegangen mit testgetriebener Entwicklung (tdd) und strukturiertem Debugging (diagnosing-bugs).
Architektonischer Verfall bei schneller, agentengetriebener Entwicklung — verhindert durch designorientierte Skills wie improve-codebase-architecture.

Im Gegensatz zu großen All-in-one-"Agent-Framework"-Projekten bleibt Skills bewusst klein und meinungsfrei: Jeder Skill ist eine eigenständige, editierbare Markdown-Datei und nicht Teil eines monolithischen Systems. Das macht die Sammlung leicht lesbar, anpassbar, forkbar oder auf genau das reduzierbar, was ein Team braucht, anstatt einen vollständigen, vorschreibenden Workflow zu übernehmen.

3. Skill-Kategorien

🛠️ Engineering-Skills — nutzeraufgerufen (8 Skills): werden vom Entwickler explizit ausgelöst, um einen Workflow zu orchestrieren.

ask-matt — Router, der hilft, den richtigen Skill für eine Aufgabe zu finden
grill-with-docs — Interview-Sitzungen, die das Domänenmodell eines Projekts aufbauen
triage — Issue-Status verwalten und priorisieren
improve-codebase-architecture — architektonische Verbesserungen aufzeigen und vorschlagen
implement — Funktionen mit integriertem TDD entwickeln
Zweck: Entwicklern explizite Einstiegspunkte für gängige High-Level-Engineering-Workflows bieten.

🤖 Engineering-Skills — modellaufgerufen (8 Skills): Der Agent entscheidet, wann er sie während einer Aufgabe anwendet.

tdd — erzwingt eine testgetriebene Entwicklungs-Schleife
diagnosing-bugs — strukturierte, hypothesengetriebene Debugging-Methodik
research — Untersuchungs-Workflow, der zitierte Quellen erfordert
domain-modeling — stärkt und erhält eine konsistente Projektterminologie
code-review — wendet zweiachsige Bewertungsstandards an (Korrektheit + Spezifikationstreue)
Zweck: Engineering-Disziplin direkt in das Standardverhalten des Agenten einbauen, ohne dass der Entwickler darum bitten muss.

📈 Produktivitäts-Skills — nutzeraufgerufen (4 Skills): entwicklerausgelöste Workflow-Helfer.

grill-me — erschöpfende Planungsinterviews vor großen Aufgaben
handoff — erzeugt Gesprächszusammenfassungen, um Arbeit an eine andere Agenten-Sitzung zu übergeben
teach — Multi-Sitzungs-Skill-Unterweisung für das Onboarding
writing-great-skills — Referenzleitfaden zum Erstellen neuer Skills
Zweck: Planung, Onboarding und Sitzungs-zu-Sitzungs-Kontinuität optimieren.

🔁 Produktivitäts-Skills — modellaufgerufen (1 Skill): Hintergrund-Workflow-Unterstützung.

grilling — eine wiederverwendbare Interview-Schleife, die von anderen Skills genutzt wird
Zweck: Einen gemeinsamen Baustein bereitstellen, das andere Interview-Skills aufrufen können.

4. Hauptmerkmale

Von Natur aus zusammensetzbar — jeder Skill ist eine kleine, unabhängige SKILL.md-Datei, sodass Teams nur das übernehmen können, was sie brauchen, und den Rest frei bearbeiten können.
Duales Aufrufmodell — Skills sind in nutzeraufgerufene (du fragst danach) und modellaufgerufene (der Agent wendet sie automatisch an) unterteilt, was eine feingranulare Kontrolle über das Agentenverhalten ermöglicht.
Integrierte TDD-Disziplin — die Skills tdd und implement drängen Agenten dazu, Tests vor dem Code zu schreiben, und zielen direkt auf das Fehlermuster "fehlerhafter Code durch schwache Feedback-Schleifen".
Strukturiertes Debugging statt Raten — diagnosing-bugs und research verlangen von Agenten, Hypothesen zu bilden und Quellen zu zitieren, anstatt frei zu improvisieren.
Verankerung in der Domänensprache — CONTEXT.md und domain-modeling sorgen dafür, dass Agenten die tatsächliche Projektterminologie verwenden statt allgemeiner Formulierungen.
Mehrere Installationspfade — funktioniert als verwaltetes, automatisch aktualisierendes Claude-Code-Plugin oder als editierbare Dateien über npx skills für Codex und andere Agenten.

5. Anwendungsfälle nach Rolle

Allgemeine Entwickler: grill-me und implement nutzen, um eine vage Funktionsanfrage in eine klar abgegrenzte, testabgedeckte Implementierung zu verwandeln, und handoff, um die Arbeit über Sitzungen hinweg wieder aufzunehmen.
Projekt-/Tech-Leads: improve-codebase-architecture und code-review nutzen, um Architektur- und Review-Standards konsistent zu halten, während Agenten mehr Code beitragen.
Teams, die KI-Agenten in eine Codebasis integrieren: setup-matt-pocock-skills, CONTEXT.md und domain-modeling nutzen, um Agenten ein gemeinsames Vokabular zu geben und Fehlausrichtungen von Anfang an zu reduzieren.

6. Erste Schritte

Finde, was du brauchst — durchstöbere den Skill-Katalog und die Kategorien im Repository oder frage den Router-Skill in einer Agenten-Sitzung:

/ask-matt

Installieren / integrieren:

# Claude-Code-Plugin (verwaltet, automatisch aktualisierend)
claude plugins install mattpocock-skills
# oder in einer Claude-Code-Sitzung:
/plugin install mattpocock-skills

# Codex und andere Agenten (editierbare lokale Dateien)
npx skills@latest add mattpocock/skills

# Einmalige Einrichtung pro Repository
/setup-matt-pocock-skills

Mitwirken — die Skills sind bewusst klein und leicht anpassbar; forke das Repository, bearbeite oder füge eine SKILL.md hinzu und erstelle einen Pull-Request gemäß der Anleitung in writing-great-skills.

7. Projektstruktur

skills/
├── .agents/            # Agenten-Konfigurationsdateien
├── .claude-plugin/      # Claude-Code-Plugin-Konfiguration
├── .github/workflows/   # CI-Workflows
├── docs/                # Dokumentation
├── scripts/             # Build- und Hilfsskripte
├── skills/
│   ├── engineering/     # Codefokussierte Skills (tdd, code-review, usw.)
│   └── productivity/    # Allgemeine Workflow-Skills (grill-me, handoff, usw.)
├── AGENTS.md            # Agentenorientierte Dokumentation
├── CLAUDE.md            # Claude-spezifische Einrichtungshinweise
├── CONTEXT.md           # Projekt-Domänenmodell und Terminologie
└── LICENSE              # MIT-Lizenz

Jeder Skill lebt in einem eigenen Verzeichnis mit einer dedizierten SKILL.md, die beschreibt, wann und wie er verwendet werden sollte, was die Sammlung leicht durchsuchbar und erweiterbar macht.

8. Verwandtes Ökosystem

Abhängigkeiten: Claude Code (Anthropics Coding-Agent-CLI) und Codex, die beiden primären Agenten-Laufzeitumgebungen, für die die Skills entwickelt wurden; das npm-Paket/CLI skills (npx skills) für Installation und Updates.
Komplementäre Tools: Jeder Markdown-getriebene Agent, der das Laden benutzerdefinierter Skills/Plugins unterstützt, kann diese Skill-Dateien prinzipiell nutzen, da jede SKILL.md ein eigenständiger Anweisungssatz ist.

9. Lizenz

✅ Code für persönliche oder kommerzielle Projekte verwenden, modifizieren und weiterverbreiten (gemäß MIT-Lizenz erlaubt).
✅ Repository forken und einzelne Skills an den Workflow des eigenen Teams anpassen.
❌ Den ursprünglichen Copyright- und Lizenzhinweis aus weiterverbreiteten Kopien nicht entfernen.
ℹ️ Die MIT-Lizenz stellt die Software "wie sie ist" ohne Gewährleistung bereit — vor der Produktionsnutzung die LICENSE-Datei im Repository für die vollständigen Bedingungen prüfen.

10. FAQ

F: Brauche ich Claude Code, um diese Skills zu nutzen?
A: Nein — Claude-Code-Nutzer können über den Plugin-Marketplace installieren, während Codex- und andere Agenten-Nutzer editierbare Dateien mit npx skills@latest add mattpocock/skills installieren können.

F: Wie halte ich die Skills aktuell?
A: Das Claude-Code-Plugin aktualisiert sich automatisch; für manuell installierte Dateien npx skills update ausführen.

F: Was ist der Unterschied zwischen nutzeraufgerufenen und modellaufgerufenen Skills?
A: Nutzeraufgerufene Skills werden von dir explizit ausgelöst (z. B. /grill-me), während modellaufgerufene Skills (z. B. tdd, diagnosing-bugs) automatisch vom Agenten angewendet werden, wenn sie relevant sind.

F: Kann ich meinen eigenen Skill schreiben?
A: Ja — siehe den Skill writing-great-skills im Repository für Autorenanleitung und Konventionen.

F: Gibt es einen erforderlichen Einrichtungsschritt nach der Installation?
A: Ja — /setup-matt-pocock-skills einmal pro Repository ausführen, um Issue-Tracking, Triage-Labels und den Dokumentationsort zu konfigurieren.

11. Schnelllinks

Repository: https://github.com/mattpocock/skills
Lizenz: https://github.com/mattpocock/skills/blob/main/LICENSE
Issues: https://github.com/mattpocock/skills/issues
Diskussionen/Community: über die Issues und Pull Requests des Repositorys

12. Zusammenfassung

Skills bietet Teams ein leichtgewichtiges, editierbares Toolkit, um KI-Coding-Agenten mehr wie disziplinierte Ingenieure agieren zu lassen — Planung vor dem Coden, Testen vor dem Ausliefern und Verankerung in der realen Domänensprache des Projekts. Es eignet sich am besten für Entwickler und Tech-Leads, die bereits auf Claude Code oder Codex setzen und konsistentere, review-fähige Ausgaben ohne ein schwergewichtiges Framework wünschen.