Superpowers: Skills für KI-Coding-Agents

1. Projektübersicht

Superpowers ist eine Open-Source-Softwareentwicklungsmethodik für KI-Coding-Agents – eine kombinierbare Bibliothek von „Skills“, die Tools wie Claude Code, Cursor und Codex CLI durch einen disziplinierten, evidenzbasierten Workflow führt, anstatt sie direkt in ad-hoc-Programmierung springen zu lassen.

2. Hintergrund und Positionierung

Superpowers wurde entwickelt, um ein häufiges Versagensmuster von KI-Coding-Agents zu lösen: zuerst Code schreiben und erst später nachdenken, Design-Reviews überspringen, Tests auslassen und Aufgaben ohne echte Überprüfung als „erledigt“ deklarieren. Seine Kernmission ist es, Agents einen wiederholbaren, professionellen Prozess zu bieten – Brainstorming, Planung, isolierte Ausführung, testgetriebene Entwicklung und Code-Review –, damit von Agents generierte Software denselben Standards entspricht, die auch von einem menschlichen Engineering-Team erwartet werden.

Im Gegensatz zu Single-Purpose-Prompt-Bibliotheken oder einmaligen „Coding-Agent“-Wrappern ist Superpowers ausdrücklich eine Methodik plus eine Skill-Bibliothek, kein einzelnes Tool. Es ist von Grund auf agentenagnostisch: Dasselbe Skill-Set lässt sich in über 13 verschiedene Coding-Agents installieren (Claude Code, Cursor, Gemini CLI, GitHub Copilot CLI, Devin und mehr), statt an das Ökosystem eines einzelnen Anbieters gebunden zu sein. Es bevorzugt zudem „systematische statt ad-hoc“-Entscheidungsfindung und „Evidenz vor Behauptungen“, was es von leichtgewichtigeren Prompt-Engineering-Sammlungen unterscheidet, die keine Prozessdisziplin erzwingen.

3. Feature-Kategorien

🧪 Testing — 1 Skill. test-driven-development erzwingt einen strengen RED-GREEN-REFACTOR-Zyklus, sodass Agents einen fehlschlagenden Test schreiben, bevor sie Implementierungscode verfassen.
🐞 Debugging — 2 Skills. systematic-debugging steuert die Ursachenanalyse statt auf Vermutungen zu setzen; verification-before-completion verhindert, dass ein Agent Arbeit als „erledigt“ markiert, ohne tatsächliche Beweise für deren Funktionsfähigkeit.
🤝 Zusammenarbeit — 9 Skills. Umfasst brainstorming (Designvalidierung mit dem Benutzer vor der Programmierung), writing-plans / executing-plans (Aufgabenaufteilung und -ausführung), dispatching-parallel-agents (Verteilung von Arbeit an Subagents), requesting-code-review / receiving-code-review, using-git-worktrees (isolierte, sichere Entwicklungszweige), finishing-a-development-branch und subagent-driven-development.
🧩 Meta — 2 Skills. writing-skills dokumentiert, wie man neue Skills erstellt; using-superpowers erklärt, wie das Framework selbst aufgerufen und kombiniert werden soll.

4. Wichtige Highlights

Siebenstufiger Entwicklungsworkflow — jede Aufgabe durchläuft Design-Brainstorming, Git-Worktree-Isolation, Aufgabenaufteilung, Subagent-Ausführung mit Review-Zyklen, TDD, spezifikationsbasiertes Code-Review und Branch-Bereinigung, was der agentengesteuerten Entwicklung eine konsistente Struktur gibt.
Agentenagnostische Installation — funktioniert mit über 13 Coding-Agents (Claude Code, Cursor, Codex CLI, Gemini CLI, GitHub Copilot CLI, Devin, Antigravity, Factory Droid, Grok Build CLI, Kimi Code, OpenCode, Pi, Hermes Agent), sodass Teams nicht an einen einzigen Anbieter gebunden sind.
Testgetriebene Entwicklung als Standard — der Skill test-driven-development macht RED-GREEN-REFACTOR zum Standardzyklus statt zu einer optionalen Disziplin.
Evidenz-vor-Behauptungen-Verifizierung — verification-before-completion wurde speziell entwickelt, um zu verhindern, dass Agents Erfolg ohne Beweis selbst melden.
Git-Worktree-Isolation — die Entwicklung findet in isolierten Worktrees statt, wodurch verhindert wird, dass experimentelle oder laufende Agent-Arbeit den Hauptzweig destabilisiert.
Kombinierbare, erweiterbare Skill-Bibliothek — Skills sind modulare Markdown-basierte Einheiten (SKILL.md), und writing-skills dokumentiert das Muster für Teams, die eigene Skills hinzufügen möchten.

5. Anwendungsfälle nach Rolle

Allgemeine Entwickler — installieren Sie Superpowers in Ihrem bevorzugten Coding-Agent, um strukturierte Planung, TDD-Erzwingung und Code-Review direkt in Ihre täglichen agentenunterstützten Coding-Sitzungen zu integrieren.
Projektmanager / Tech Leads — nutzen Sie die Brainstorming- und Planungs-Skills, damit Agents Design-Abwägungen aufzeigen und überprüfbare Pläne erstellen, bevor die Implementierung beginnt, was überraschende Neuschreibungen reduziert.
Open-Source-Maintainer — die Skills using-git-worktrees und finishing-a-development-branch helfen dabei, von Agents eingereichte Branches isoliert und sauber zu halten, was den Review-Aufwand für Maintainer verringert.

(DevOps/SRE, Security Engineering sowie Daten-/Forschungswissenschaften sind keine spezifischen Schwerpunkte dieses Projekts und wurden ausgelassen.)

6. Erste Schritte

Finden Sie, was Sie brauchen
Durchsuchen Sie die Skill-Bibliothek nach Kategorie (Testing, Debugging, Zusammenarbeit, Meta) im Verzeichnis skills/ des Repositories oder lesen Sie docs/ für agentspezifische Einrichtungshinweise.

Installieren / Integrieren
Die Installation erfolgt über einen einzigen Befehl, der spezifisch für Ihren Coding-Agent ist, zum Beispiel:

# Claude Code
/plugin install superpowers@claude-plugins-official

# Cursor
/add-plugin superpowers

# Gemini CLI
gemini extensions install https://github.com/obra/superpowers

# GitHub Copilot CLI
copilot plugin install superpowers@superpowers-marketplace

Sehen Sie sich die README des Repositories für die vollständige Tabelle aller über 13 unterstützten Agents an.

Beitragen
Forken Sie das Repository, arbeiten Sie vom dev-Branch aus und befolgen Sie die in skills/writing-skills/SKILL.md dokumentierte Methodik, bevor Sie einen Pull Request öffnen. Beachten Sie, dass Maintainer angeben, Beiträge völlig neuer Skills generell nicht zu akzeptieren – Fehlerbehebungen und Verbesserungen bestehender Skills sind der primäre Weg für Beiträge.

7. Projektstruktur

superpowers/
├── .claude-plugin/     # Claude Code Plugin-Manifest
├── .cursor-plugin/     # Cursor Plugin-Manifest
├── .devin-plugin/      # Devin Plugin-Manifest
├── .kimi-plugin/       # Kimi Code Plugin-Manifest
├── .opencode/          # OpenCode-Erweiterung + INSTALL.md
├── .pi/extensions/     # Pi Erweiterungsmanifest
├── .agents/plugins/    # Gemeinsame Agent-Plugin-Definitionen
├── skills/             # Kern-Skill-Bibliothek (SKILL.md pro Skill)
├── docs/               # Agentspezifische und allgemeine Dokumentation
├── hooks/              # Workflow-Hooks
├── scripts/            # Unterstützende Automatisierungsskripte
├── assets/             # Statische Assets (Logo, Telemetrie-Pixel usw.)
└── tests/              # Testsuite / Evaluierungs-Framework

Das Verzeichnis skills/ ist das Herzstück des Projekts – jeder Skill ist eine eigenständige SKILL.md, die beschreibt, wann und wie ein Agent ihn anwenden soll. Die Verzeichnisse .{agent}-plugin/ passen dieselbe Skill-Bibliothek an das Plugin-Format jedes unterstützten Coding-Agents an.

8. Verwandtes Ökosystem

Superpowers hängt von den Coding-Agent-Plattformen ab, in die es installiert wird – Claude Code, Cursor, Gemini CLI, GitHub Copilot CLI, Codex CLI, Devin, Antigravity, Factory Droid, Grok Build CLI, Kimi Code, OpenCode, Pi und Hermes Agent –, die jeweils die zugrundeliegende LLM-Laufzeitumgebung und den Plugin-/Erweiterungsmechanismus bereitstellen, auf dem die Skills von Superpowers laufen. Es ergänzt (statt ersetzt) die nativen Fähigkeiten jedes Agents, indem es eine gemeinsame Entwicklungsmethodik darüberlegt.

9. Lizenz

✅ Frei zur Nutzung, Vervielfältigung, Modifikation, Zusammenführung, Veröffentlichung und Verteilung, einschließlich kommerzieller Zwecke (MIT-Lizenz).
✅ Frei zur Installation in jedem unterstützten Coding-Agent, privat oder organisatorisch.
❌ Keine Gewährleistung – die Software wird „wie besehen“ bereitgestellt.
ℹ️ Der ursprüngliche Urheberrechts- und Lizenzhinweis muss in Kopien oder wesentlichen Teilen der Software beibehalten werden.
ℹ️ Das Projekt enthält optionale, deaktivierbare Telemetrie (Versionsverfolgung via Logo-Lade-Beacon); sie kann über eine Umgebungsvariable deaktiviert werden.

10. FAQ

F: Funktioniert Superpowers mit meinem Coding-Agent?
A: Es unterstützt über 13 Agents, einschließlich Claude Code, Cursor, Gemini CLI, GitHub Copilot CLI, Codex CLI und Devin – prüfen Sie die Installationstabelle in der README für den genauen Befehl für Ihren Agent.

F: Ist Superpowers ein einzelnes Tool oder eine Sammlung von Prompts?
A: Weder noch genau – es ist eine strukturierte Methodik, implementiert als kombinierbare Skill-Bibliothek (skills/), die dafür ausgelegt ist, von einem Agent während eines gesamten Entwicklungsworkflows aufgerufen zu werden, statt als einmaliger Prompt.

F: Kann ich einen neuen Skill beitragen?
A: Sie können einen Pull Request öffnen, aber Maintainer weisen darauf hin, dass sie Beiträge völlig neuer Skills generell nicht akzeptieren; Beiträge, die bestehende Skills, Dokumentation oder Agent-Integrationen verbessern, werden eher gemergt. Siehe skills/writing-skills/SKILL.md für das erforderliche Format.

F: Sammelt es meine Daten?
A: Es enthält optionale Telemetrie, die auf Versionsverfolgung beschränkt ist und eine Opt-out-Umgebungsvariable respektiert.

F: Wie aktualisiere ich Superpowers nach der Installation?
A: Die Aktualisierung folgt dem normalen Plugin-/Erweiterungs-Update-Mechanismus Ihres Coding-Agents; siehe Abschnitt „Updating“ in der README des Repositories für detailspezifische Informationen zu Ihrem Agent.

11. Quick Links

Repository: https://github.com/obra/superpowers
Beitragsrichtlinien: skills/writing-skills/SKILL.md (im Repository)
Agentspezifische Dokumentation: Verzeichnis docs/ (im Repository)
Community: GitHub Issues und Discussions im Repository

12. Zusammenfassung

Superpowers verwandelt ad-hoc-KI-unterstützte Programmierung in einen disziplinierten, evidenzbasierten Engineering-Prozess – Brainstorming, Planung, TDD und Code-Review –, der sich in jeden Coding-Agent installieren lässt, den ein Team bereits verwendet. Es ist besonders wertvoll für Entwickler und Teams, die möchten, dass ihre KI-Coding-Agents sich wie sorgfältige Ingenieure verhalten statt wie schnelle, aber schlampige Autovervollständigung, ohne an einen einzigen Agent-Anbieter gebunden zu sein.