Superpowers Quickstart: Installation, Workflow und Test

Superpowers bündelt eine vollständige, spec-getriebene Methodik in installierbare Claude Skills und erzwingt Brainstorming, Planung, Subagent-gesteuerte Implementierung und striktes TDD, anstatt diese Struktur Ihnen zu überlassen.

Die meisten SDD-Setups mit Claude Code scheitern auf dieselbe Weise: Jemand schreibt einmal ein solides specify-plan-implement-Skill, nutzt es eine Woche lang gewissenhaft, um dann beim ersten Anrücken einer Deadline still und leise zu unstrukturiertem Prompting zurückzukehren. Ein selbst erstelltes Skill verhindert das tatsächlich in keiner Weise. Superpowers ist eine direkte Antwort auf dieses Disziplinproblem – ein Skills-Paket, das von Jesse Vincent und dem Team bei Prime Radiant entwickelt wurde und Brainstorming, Planung, Subagent-Review sowie red-green-refactor-TDD als verpflichtende Schritte behandelt, die der Agent vor jeder Aufgabe prüft, anstatt sie als optionale Vorschläge zu betrachten, die er unter Druck überspringen kann.

Was es wert ist, einen eigenen Blick zu erhalten, statt nur in einer Fußnote zu stehen, ist die Installationsgeschichte. Superpowers bietet Plugin-Manifeste für Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Devin CLI, Factory Droid und Hermes Agent, sodass dieselbe Methodik Sie über verschiedene Umgebungen hinweg begleitet, anstatt in einem .claude/skills/-Ordner eines einzelnen Repositories zu leben. Dieser Leitfaden behandelt, was es tatsächlich ist, wie man es auf dem Agenten installiert und verifiziert, den Sie verwenden, wie ein erster End-to-End-Lauf aussieht und wo es im Vergleich zu anderen spez-getriebenen Entwicklungstools einzuordnen ist.

Was ist Superpowers?

Superpowers beschreibt sich selbst als „eine vollständige Softwareentwicklungs-Methodik für Ihre Coding-Agenten, die auf einer Reihe zusammensetzbarer Skills und einigen Anfangsanweisungen basiert, die sicherstellen, dass Ihr Agent sie verwendet“. Dieser letzte Teil ist der entscheidende. Es gibt zahlreiche Skill-Sammlungen; der Unterschied hier liegt in der Bootstrap-Anweisung, die den Agenten zwingt, vor dem Start einer jeden Aufgabe nach relevanten Skills zu suchen, sodass der Workflow automatisch aktiviert wird, anstatt dass Sie sich an einen Slash-Befehl erinnern müssen.

Die Philosophie dahinter wird in den eigenen Dokumentationen des Projekts klar formuliert:

• Test-Driven Development – schreiben Sie immer zuerst Tests
• Systematisch statt ad-hoc – Prozess statt Raten
• Komplexitätsreduzierung – Einfachheit als primäres Ziel
• Beweise statt Behauptungen – verifizieren Sie, bevor Sie Erfolg erklären

In der Praxis zeigt sich diese Philosophie als eine Abfolge von Skills, die sich gegenseitig die Arbeit übergeben. Wenn Sie Claude Skills und SKILL.md für Entwickler gelesen haben, werden Ihnen die Mechaniken vertraut vorkommen – Superpowers ist eine große, meinungsstarke Sammlung genau dieser Art von SKILL.md-Verzeichnissen, die als installierbares Plugin verteilt wird, anstatt dass Sie es selbst erstellen.

Superpowers über verschiedene Coding-Agenten hinweg installieren

Die Installation ist umgebungsabhängig, und das Projekt stellt ausdrücklich klar, dass Sie es separat für jeden Agenten installieren, den Sie verwenden – es gibt keine einzelne globale Installation.

Claude Code

Superpowers wird über zwei Marktplätze für Claude Code verteilt:

# Offizieller Anthropic-Plugin-Marktplatz
/plugin install superpowers@claude-plugins-official

Oder über den dedizierten Superpowers-Marktplatz, der auch einige verwandte Plugins anbietet:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Cursor

/add-plugin superpowers

Sie können auch direkt „superpowers“ in der Plugin-Marktplatz-Oberfläche von Cursor suchen.

Weitere Agenten

Einige Installationsdetails sind es wert, hervorgehoben zu werden, bevor Sie eine echte Aufgabe ausführen:

• Antigravity führt den Session-Start-Hook des Plugins automatisch aus, sodass Superpowers ab der ersten Nachricht aktiv ist; installieren Sie mit demselben Befehl neu, um zu aktualisieren.
• Pi lädt die Skills über eine kleine Erweiterung, die das using-superpowers-Bootstrap beim Session-Start und nach der Kontextkompaktierung injiziert, und benötigt nicht das Kompatibilitäts-Skill-Tool von Pi, da Pi native Skill-Unterstützung hat.
• Hermes Agent hat keinen Post-Compaction-Hook – eine sehr lange Session, die über ihren ersten Turn kompaktiert wird, kann das Bootstrap verlieren; starten Sie also eine neue Session, wenn die Skills nicht mehr ausgelöst werden.
• OpenCode behandelt dies als einen komplett separaten Installationspfad von jeder anderen Umgebung, die Sie bereits verwenden, auch auf demselben Computer.

Installation verifizieren

Sobald installiert, fragen Sie den Agenten direkt, anstatt einer stillen Erfolgsmeldung zu vertrauen:

What skills are available?

Wenn Superpowers korrekt installiert wurde, sollte der Agent Skills wie brainstorming, writing-plans, test-driven-development und subagent-driven-development unter den Ergebnissen auflisten. Dies ist dieselbe Entdeckungsprüfung, die für das Debuggen von Claude Skills, die nicht auslösen empfohlen wird – wenn das Skill existiert, aber nie aktiviert wird, liegt das fast immer an der Routing-Beschreibung, nicht am Modell.

Der Superpowers-Workflow: Vom Brainstorming zum ausgelieferten Code

Superpowers dokumentiert sieben Skills als „den grundlegenden Workflow“, wobei jedes an einem bestimmten Punkt aktiviert wird und an das nächste übergibt:

⬇

1. brainstorming wird aktiviert, bevor Code geschrieben wird. Es verfeinert eine grobe Idee durch Fragen, erkundet Alternativen und präsentiert das Design in kurzen, überprüfbaren Blöcken, anstatt in einem langen Dokument – und speichert das Ergebnis als Design-Artefakt.
2. using-git-worktrees wird aktiviert, sobald Sie das Design genehmigen. Es erstellt einen isolierten Arbeitsbereich auf einem neuen Branch, führt das Projekt-Setup aus und verifiziert eine saubere Testbasis, bevor die Implementierung beginnt.
3. writing-plans zerlegt das genehmigte Design in kleine Aufgaben – Superpowers zielt auf zwei bis fünf Minuten Arbeit pro Aufgabe – mit genauen Dateipfaden, vollständigem Code, wo relevant, und expliziten Verifizierungsschritten.
4. subagent-driven-development (schnelle Iteration) oder executing-plans (Batch-Ausführung mit menschlichen Prüfpunkten) setzt einen frischen Subagenten pro Aufgabe ein, mit einer zweistufigen Überprüfung: zuerst Spezifikationskonformität, dann Codequalität.
5. test-driven-development erzwingt striktes red-green-refactor – schreiben Sie einen fehlschlagenden Test, beobachten Sie das Fehlschlagen, schreiben Sie den minimalen Code zum Bestehen, beobachten Sie das Bestehen, committen Sie. Code, der vor dem Existieren eines fehlschlagenden Tests dafür geschrieben wurde, wird gelöscht, nicht behalten.
6. requesting-code-review wird zwischen Aufgaben aktiviert, überprüft den Diff gegen den Plan und berichtet Probleme nach Schweregrad; kritische Probleme blockieren den Fortschritt zur nächsten Aufgabe.
7. finishing-a-development-branch wird aktiviert, sobald alle Aufgaben abgeschlossen sind. Es verifiziert, dass die Tests bestehen, präsentiert dann Optionen – mergen, einen PR öffnen, den Branch behalten oder verwerfen – und räumt den Worktree auf.

Dies entspricht eng dem umgebungsneutralen Fünf-Phasen-Loop in Spec-Driven Development Workflow Von Anforderungen zu Code: specify wird zu brainstorming, plan wird zu writing-plans, tasks und implement werden in subagent-driven-development zusammengefasst, und validate wird auf TDD und Code-Review aufgeteilt. Der Unterschied liegt in der Durchsetzung – Superpowers ist so gebaut, dass der Agent automatisch nach diesen Skills sucht, anstatt sich darauf zu verlassen, dass Sie jede Phase aufrufen.

Es ausprobieren: Ein erster Aufgaben-Durchlauf

Zeigen Sie Superpowers nicht bei der ersten Ausführung auf Ihre wichtigste Funktion. Wählen Sie etwas Reales, aber Begrenztes – einen kleinen Endpunkt, einen fokussierten Bugfix, eine einzelne Modul-Refactorisierung – und starten Sie eine Session in einem Projekt, das bereits eine Test-Suite hat, da die TDD-Durchsetzung dort am sichtbarsten ist.

I want to add rate limiting to our public API endpoints.

Mit installiertem Superpowers ist zu erwarten, dass die Session mit Brainstorming-Fragen statt Code eröffnet wird: welche Endpunkte, welches Limit, pro Benutzer oder pro Schlüssel, was passieren soll, wenn das Limit erreicht wird. Diese Reibung ist beabsichtigt – es ist dieselbe Non-Goals-Disziplin, die in Spec-Driven Development Workflow Von Anforderungen zu Code behandelt wird, nur dass sie durch das Skill erzwungen wird, anstatt dass Sie sich daran erinnern müssen. Sobald Sie das Design in Blöcken genehmigen, ist ein Plan mit nummerierten, kleinen Aufgaben zu erwarten, bevor Dateiänderungen erfolgen, dann ein Subagent pro Aufgabe mit einem Diff, den Sie an jedem Prüfpunkt überprüfen.

Zwei Dinge, auf die bei einer ersten Ausführung zu achten ist:

• Bestätigen Sie, dass TDD tatsächlich erzwungen wird. Bitten Sie den Agenten, eine Aufgabe zu implementieren, und überprüfen Sie, ob ein fehlschlagender Test vor der Implementierung erscheint. Wenn Code zuerst landet, hat das Skill diesen Schritt nicht ausgelöst, und es lohnt sich, die Entdeckungsprüfung aus dem Installationsabschnitt erneut auszuführen.
• Achten Sie auf die Granularität der Aufgaben. Die Aufgabengröße von zwei bis fünf Minuten ist für einige Codebasen aggressiv. Wenn Aufgaben für Ihr Projekt unnötig fragmentiert wirken, ist es wert, dies während des writing-plans-Review-Prüfpunkts anzubringen, anstatt nachträglich.

Was drin ist: Die Skills-Bibliothek

Neben den sieben Workflow-Skills liefert Superpowers unterstützende Skills, gruppiert nach Bereich:

dispatching-parallel-agents ist es wert, separat hervorgehoben zu werden: Es behandelt parallele Subagenten-Workflows, was dasselbe Terrain wie Claude Code Subagents ist – isolierter Kontext, unabhängige Überprüfung und eine Zusammenfassung, die an die Haupt-Session zurückgemeldet wird, anstatt sie mit Zwischenoutput zu fluten.

Wann Superpowers passt (und wann nicht)

Gute Passform:

• Sie mögen bereits den Claude Code Skills-Ansatz für Spec-Driven Development vs Vibe Coding, rutschen aber immer wieder zu unstrukturiertem Prompting zurück, weil nichts die Review-Gates erzwingt.
• Sie arbeiten mit mehreren Coding-Agenten und wollen eine Methodik, die mit Ihnen reist, anstatt eines nur für Claude Code bestimmten Skills.
• Sie wollen strikte TDD-Durchsetzung, ohne die Durchsetzungslogik selbst zu schreiben.
• Multi-Session-Funktionen, bei denen architektonischer Drift und vergessene Beschränkungen ein reales Risiko darstellen – genau das Fehlerszenario, das in Spec-Driven Development vs Vibe Coding beschrieben wird.

Schwächere Passform:

• Schnelle Skripte, Wegwerf-Prototypen und einmalige Automatisierung – der Overhead für Brainstorming und Planung ist real und lohnt sich nicht für eine Änderung von fünfzig Zeilen.
• Teams mit einer bestehenden, gut abgestimmten, projektspezifischen SDD-Skill. Superpowers tauscht diese Anpassung gegen erzwungene, meinungsstarke Zeremonie ein; Sie können es vorziehen, das, was bereits funktioniert, beizubehalten und nur einzelne Skill-Ideen zu übernehmen.
• Umgebungen, in denen die strenge Aufgabengranularität von zwei bis fünf Minuten oder das obligatorische TDD mit einem etablierten Teamprozess kollidieren würden, den Sie nicht bereit sind zu ändern.

Wie sich Superpowers von anderen SDD-Tools unterscheidet

Superpowers ist im üblichen Sinne kein Konkurrent von GitHub Spec Kit oder AWS Kiro – es operiert auf der Claude Code / cross-agent Skills-Ebene, anstatt als eigenständige CLI oder IDE. Spec Kit bietet Ihnen portable Markdown-Artefakte und Agenten-Unabhängigkeit; Kiro bietet Ihnen eine geführte, integrierte IDE-Erfahrung; ein selbst erstelltes Claude Code Skill bietet Ihnen maximale Flexibilität mit null Durchsetzung. Superpowers liegt zwischen den letzten beiden: derselbe skills-basierte Mechanismus wie ein DIY-Claude-Code-Workflow, aber mit gefühlt verpflichtender Durchsetzung und cross-agent-Plugin-Verteilung, die ein repo-lokales Skill nicht bietet.

Für die vollständige Aufschlüsselung der Portabilität, Setup-Reibung, Review-Gates und Lock-in über Spec Kit, Kiro, Claude Code Skills, OpenSpec, BMAD-METHOD und Tessl – einschließlich, wo Superpowers in der Vergleichstabelle und im Entscheidungsrahmen einzuordnen ist – siehe GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows.

Troubleshooting und Dinge, die man wissen sollte

Updates sind größtenteils automatisch, aber agentenabhängig. Wie aktuell Ihre Installation bleibt, hängt von der Umgebung ab – Antigravity führt den Session-Start-Hook bei der Neuinstallation erneut aus, npm- oder Git-basierte Installationen benötigen einen expliziten Update-Befehl, und marktplatzbasierte Installationen folgen typischerweise dem eigenen Plugin-Update-Flow des Host-Agenten.

Telemetrie ist standardmäßig aktiv, aber leicht zu deaktivieren. Der optionale visuelle Begleiter des Brainstorming-Skills lädt das Prime Radiant-Logo von ihrer Website, das Ihre Superpowers-Version enthält, aber keine Projekt-, Prompt- oder Klickdaten. Setzen Sie SUPERPOWERS_DISABLE_TELEMETRY auf einen beliebigen wahren Wert, um es auszuschalten. Superpowers berücksichtigt auch die eigenen DISABLE_TELEMETRY- und CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC-Opt-outs von Claude Code.

Beiträge erfordern den dev-Branch. Wenn Sie Skills ändern oder hinzufügen möchten, fork das Repository, wechsle zu dev und folge dem writing-skills-Skill zum Erstellen und Testen von Änderungen – neue Skill-Beiträge werden im Allgemeinen nicht akzeptiert, da jedes Skill identisch über alle unterstützten Agenten hinweg funktionieren muss.

Wenn ein Skill nicht ausgelöst wird, behandeln Sie es wie jedes andere Claude Skill-Problem. Fragen Sie „What skills are available?“, um die Entdeckung zu bestätigen, prüfen Sie, dass Sie es für den spezifischen Agenten installiert haben, den Sie gerade verwenden (nicht einen anderen auf demselben Computer), und denken Sie daran, dass Hermes-Sessions nach einer Kompaktierung langer Sessions einen Neustart benötigen, wenn das Bootstrap still und leise verloren geht.

Fazit

Superpowers ist es wert, installiert zu werden, wenn die Lücke zwischen Ihren SDD-Intentionen und dem, was tatsächlich in einer Session passiert, das Problem ist, das Sie lösen möchten. Es führt keine neue specify-plan-implement-Idee ein – dieser Loop wird bereits gut durch Was ist Spec-Driven Development? abgedeckt – es macht eine bestehende Idee schwieriger zu überspringen, und es tut das über mehr Agenten hinweg, als ein repo-lokales Skill erreichen kann. Installieren Sie es zuerst auf der einen Umgebung, die Sie täglich verwenden, führen Sie eine kleine, begrenzte Aufgabe durch den vollständigen Brainstorm-zu-Finish-Zyklus und entscheiden Sie dann, ob die erzwungene Zeremonie sich für Ihre tatsächliche Arbeitslast lohnt.

Nützliche Links

• Superpowers Repository – Quellcode, Skills und Plugin-Manifeste für jeden unterstützten Agenten
• Superpowers Marketplace – Claude Code Marketplace für Superpowers und verwandte Plugins
• GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows – vollständiger Tool-Vergleich und Entscheidungsrahmen
• Claude Skills und SKILL.md für Entwickler – die zugrunde liegenden Skill-Mechaniken, auf denen Superpowers aufbaut
• Claude Code Subagents: Setup, Konfiguration und wann man sie verwendet – Review mit isoliertem Kontext, der Mechanismus hinter subagent-driven-development
• Spec-Driven Development Workflow Von Anforderungen zu Code – der umgebungsneutrale Fünf-Phasen-Prozess, den Superpowers automatisiert
• Was ist Spec-Driven Development? Die Spezifikation als Single Source of Truth – Kernkonzepte und Terminologie von SDD
• Claude Code Installation und Konfiguration für Ollama, llama.cpp, Preise – installieren Sie Claude Code selbst, bevor Sie Superpowers hinzufügen