Superpowers Quickstart: Installation, Workflow und Test

Superpowers bündelt eine vollständige, spec-gesteuerte Methodik in installierbare Claude-Skills und erzwingt Brainstorming, Planung, subagentenbasierte Implementierung und striktes TDD (Testgetriebene Entwicklung), anstatt diese Struktur der freien Gestaltung zu überlassen.

Die meisten Claude-Code-SDD-Setups scheitern auf dieselbe Art und Weise: Jemand schreibt einmal ein solides specify-plan-implement-Skill, benutzt es eine Woche lang gewissenhaft, um dann still und leise zum unstrukturierten Prompting zurückzukehren, sobald ein Fälligkeitsdatum näher rückt. An einem selbst erstellten Skill fehlt es an einem Mechanismus, der dies tatsächlich verhindert. Superpowers ist eine direkte Antwort auf dieses Disziplinproblem – ein Skill-Paket, das von Jesse Vincent und dem Team bei Prime Radiant entwickelt wurde und Brainstorming, Planung, subagentenbasierte Überprüfung und red-green-refactor-TDD als verpflichtende Schritte behandelt, die der Agent vor jeder Aufgabe überprüft, und nicht als optionale Vorschläge, die unter Druck ignoriert werden können.

Was es wert macht, dass man es sich nicht nur am Rande, sondern ausführlich ansieht, ist die Installationsgeschichte. Superpowers liefert 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 Harnesses hinweg begleitet, anstatt nur im .claude/skills/-Ordner eines einzigen Repositories zu existieren. 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 spechgetriebenen Entwicklungs-Tools einzuordnen ist.

Was ist Superpowers?

Superpowers beschreibt sich selbst als „eine vollständige Softwareentwicklungs-Methodik für Ihre Coding Agents, aufgebaut auf einer Reihe kombinierbarer Skills und einigen Anfangsinstruktionen, die sicherstellen, dass Ihr Agent sie verwendet.“ Letzter Absatz ist der entscheidende Teil. Es gibt viele Skill-Sammlungen; der differenzierende Faktor hier ist die Bootstrap-Instruktion, 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 Dokuementationen des Projekts offen dargelegt:

• Testgetriebene Entwicklung (TDD) – zuerst Tests schreiben, immer
• Systematisch statt ad hoc – Prozess statt Raten
• Komplexitätsreduktion – Einfachheit als primäres Ziel
• Beweise statt Behauptungen – vor der Erfolgsdeklaration verifizieren

In der Praxis zeigt sich diese Philosophie als eine Abfolge von Skills, die aneinander übergeben. Wenn Sie Claude Skills und SKILL.md für Entwickler gelesen haben, werden Ihnen die Mechaniken vertraut vorkommen – Superpowers ist ein großes, meinungsstarkes Set aus genau dieser Art von SKILL.md-Verzeichnissen, das als installierbares Plugin verteilt wird, anstatt von Ihnen selbst erstellt zu werden.

Superpowers über Coding Agents hinweg installieren

Die Installation ist harness-spezifisch, und das Projekt legt ausdrücklich fest, 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 führt:

/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-UI von Cursor durchsuchen.

Andere Agents

Bevor Sie eine echte Aufgabe ausführen, sind einige Installationsdetails hervorzuheben:

• Antigravity führt den Session-Start-Hook des Plugins automatisch aus, sodass Superpowers ab der ersten Nachricht aktiv ist; neu installieren Sie mit demselben Befehl zum Aktualisieren.
• Pi lädt die Skills über eine kleine Erweiterung, die das using-superpowers-Bootstrap beim Session-Start und nach der Kontext-Kompaktierung injiziert, und benötigt nicht das Kompatibilitäts-Skill-Tool von Pi, da Pi nativen Skill-Support hat.
• Hermes Agent hat keinen Hook für nach der Kompaktierung – eine sehr lange Session, die sich über ihren ersten Turn hinaus kompaktiert, 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 Installationsweg von jedem anderen Harness, das Sie bereits verwenden, auch auf demselben Gerät.

Installation verifizieren

Sobald installiert, fragen Sie den Agenten direkt, anstatt eine stille 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 derselbe Entdeckungs-Check, der für das Debuggen von Claude Skills, die nicht auslösen empfohlen wird – wenn das Skill existiert, aber nie aktiviert wird, ist fast immer die Routing-Beschreibung das Problem, nicht das Modell.

Der Superpowers-Workflow: Vom Brainstorming bis zum ausgelieferten Code

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

⬇

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 Chunks anstelle eines langen Dokuments – und speichert das Ergebnis als Design-Artefakt.
2. using-git-worktrees wird aktiviert, sobald Sie das Design genehmigen. Es erstellt einen isolierten Workspace 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 exakten Datei-Pfaden, vollständigem Code, wo relevant, und expliziten Verifikations-Schritten.
4. subagent-driven-development (schnelle Iteration) oder executing-plans (Stapel-Ausführung mit menschlichen Kontrollpunkten) entsendet einen frischen Subagenten pro Aufgabe, mit einer zweistufigen Überprüfung: zuerst Spec-Konformität, dann Code-Qualität.
5. test-driven-development erzwingt striktes red-green-refactor – einen fehlschlagenden Test schreiben, zusehen, wie er fehlschlägt, den minimalen Code zum Bestehen schreiben, zusehen, wie er besteht, committen. 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 meldet 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, und präsentiert dann Optionen – mergen, einen PR öffnen, den Branch behalten oder verwerfen – und räumt den Worktree auf.

Dies entspricht eng der tool-neutralen Fünf-Phasen-Schleife in Spechgetriebene Entwicklungs-Workflow von Anforderungen bis Code: specify wird zu brainstorming, plan wird zu writing-plans, tasks und implement fassen sich zu subagent-driven-development, und validate wird in TDD und Code-Review aufgeteilt. Der Unterschied liegt in der Durchsetzung – Superpowers ist so gebaut, dass der Agent automatisch nach diesen Skills sucht, anstatt auf Sie zu vertrauen, um jede Phase aufzurufen.

Es ausprobieren: Eine erste Aufgaben-Begehung

Verweisen Sie Superpowers nicht auf Ihr wichtigstes Feature beim ersten Lauf. Wählen Sie etwas reales, aber abgegrenztes – ein kleines Endpoint, ein fokussierter Bugfix, ein einzelnes Modul-Refactoring – und starten Sie eine Session in einem Projekt, das bereits einen 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 sollten Sie erwarten, dass die Session mit Brainstorming-Fragen statt Code beginnt: welche Endpoints, welches Limit, pro Benutzer oder pro Schlüssel, was geschehen soll, wenn das Limit erreicht wird. Diese Reibung ist absichtlich – sie ist dieselbe Nicht-Ziele-Disziplin, die in Spechgetriebene Entwicklungs-Workflow von Anforderungen bis Code behandelt wird, nur dass sie vom Skill erzwungen wird, anstatt von Ihnen erinnert zu werden. Sobald Sie das Design in Chunks genehmigen, sollten Sie einen Plan mit nummerierten, kleinen Aufgaben erwarten, bevor Dateiänderungen vorgenommen werden, gefolgt von einem pro Aufgabe entsendeten Subagenten mit einem Diff, den Sie an jedem Kontrollpunkt überprüfen.

Zwei Dinge, auf die beim ersten Lauf 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, wurde das Skill für diesen Schritt nicht ausgelöst, und es lohnt sich, den Entdeckungs-Check aus dem Installationsabschnitt erneut auszuführen.
• Achten Sie auf die Aufgaben-Granularität. Die Zwei-bis-Fünf-Minuten-Aufgabengröße 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-Überprüfungs-Kontrollpunkts anzusprechen, anstatt danach.

Was drin ist: Die Skill-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 denselben Bereich abdeckt wie Claude Code Subagents – isolierter Kontext, unabhängige Überprüfung und eine Zusammenfassung, die an die Hauptsession zurückgemeldet wird, anstatt sie mit Zwischenausgaben zu überfluten.

Wann Superpowers passt (und wann nicht)

Gute Passform:

• Sie mögen bereits den Claude-Code-Skills-Ansatz für Spechgetriebene Entwicklung vs Vibe Coding, aber rutschen immer wieder zum unstrukturierten Prompting zurück, weil nichts die Review-Gates erzwingt.
• Sie arbeiten mit mehreren Coding Agents und möchten eine einzige Methodik, die mit Ihnen reist, anstatt ein nur für Claude Code bestimmtes Skill.
• Sie möchten strikte TDD-Durchsetzung, ohne die Durchsetzungslogik selbst zu schreiben.
• Mehr-Session-Features, bei denen architektonische Drift und vergessene Constraints ein reales Risiko darstellen – genau der Fehlermodus, der in Spechgetriebene Entwicklung vs Vibe Coding beschrieben wird.

Schwächere Passform:

• Schnelle Skripte, Wegwerf-Prototypen und Einweg-Automatisierungen – der Overhead für Brainstorming und Planung ist real und es lohnt sich nicht, ihn für eine Änderung von fünfzig Zeilen zu bezahlen.
• Teams mit einem vorhandenen, gut eingestellten projekt-spezifischen SDD-Skill. Superpowers tauscht diese Anpassung gegen erzwungene, meinungsstarke Zeremonien; Sie können es vorziehen, das zu behalten, was bereits funktioniert, und nur einzelne Skill-Ideen zu übernehmen.
• Umgebungen, in denen die strenge Zwei-bis-Fünf-Minuten-Aufgaben-Granularität oder das verpflichtende 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 zu GitHub Spec Kit oder AWS Kiro – es operiert auf der Ebene der Claude Code / Cross-Agent Skills, anstatt als eigenständiges CLI oder IDE. Spec Kit gibt Ihnen portable Markdown-Artefakte und Agenten-Unabhängigkeit; Kiro gibt Ihnen ein geführtes, integriertes IDE-Erlebnis; ein selbst erstelltes Claude Code Skill gibt Ihnen maximale Flexibilität bei null Durchsetzung. Superpowers liegt zwischen den letzteren beiden: derselbe skill-basierte Mechanismus wie ein DIY-Claude-Code-Workflow, aber mit sich verpflichtend anfühlender Durchsetzung und Cross-Agent-Plugin-Verteilung, die ein repo-lokales Skill nicht bietet.

Für die vollständige Aufschlüsselung von Portabilität, Setup-Reibung, Review-Gates und Lock-in über Spec Kit, Kiro, Claude Code Skills, OpenSpec, BMAD-METHOD und Tessl hinweg – einschließlich dessen, wo Superpowers in der Vergleichstabelle und im Entscheidungsrahmen landet – siehe GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows. Wenn Sie weniger erzwungene Zeremonien und mehr Freiheit wünschen, um auf einer Brownfield-Codebasis zu iterieren, behandelt der OpenSpec Quickstart die leichtere, ändungs-zentrierte Alternative. Und wenn die Rollen, die Ihnen fehlen, diejenigen sind, die Superpowers nicht abdeckt – Produkt-Review, Browser-QA, Sicherheitsaudit, Release Engineering – bündelt gstack sie als virtuelles Engineering-Team, das mit Superpowers kombiniert werden kann, wobei Superpowers die Disziplin innerhalb der Implementierungsphase liefert.

Fehlerbehebung und Dinge zu wissen

Updates sind größtenteils automatisch, aber agenten-abhängig. Wie aktuell Ihre Installation bleibt, hängt vom Harness 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 marktplatz-basierte Installationen folgen typischerweise dem eigenen Plugin-Update-Flow des Host-Agenten.

Telemetrie ist standardmäßig aktiv, aber leicht zu deaktivieren. Das optionale visuelle Companion des Brainstorming-Skills lädt das Prime Radiant Logo von ihrer Website, das Ihre Superpowers-Version, aber keine Projekt-, Prompt- oder Klickdaten enthält. Setzen Sie SUPERPOWERS_DISABLE_TELEMETRY auf jeden true-Wert, um es zu deaktivieren. Superpowers respektiert auch die eigenen Opt-outs von Claude Code für DISABLE_TELEMETRY und CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

Beiträge erfordern den dev-Branch. Wenn Sie Skills ändern oder hinzufügen möchten, forken Sie das Repository, wechseln Sie zu dev und befolgen Sie das writing-skills-Skill für die Erstellung und Testung von Änderungen – Beiträge neuer Skills werden im Allgemeinen nicht akzeptiert, da jedes Skill identisch über alle unterstützten Agents 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 für den spezifischen Agenten installiert haben, den Sie gerade verwenden (nicht einen anderen auf demselben Gerät), und denken Sie daran, dass Hermes-Sessions nach einer langen Session-Kompaktierung einen frischen Start benötigen, wenn das Bootstrap still und leise verloren geht.

Fazit

Superpowers lohnt sich zur Installation, wenn die Lücke zwischen Ihren SDD-Absichten und dem, was in einer Session tatsächlich passiert, das Problem ist, das Sie zu lösen versuchen. Es führt keine neue specify-plan-implement-Idee ein – dieser Zyklus ist bereits gut abgedeckt durch Was ist Spechgetriebene Entwicklung? – es macht eine bestehende Idee schwerer zu überspringen, und tut dies über mehr Agents hinweg, als ein repo-lokales Skill erreichen kann. Installieren Sie es zuerst auf dem Harness, das Sie täglich verwenden, führen Sie eine kleine, abgegrenzte Aufgabe durch den vollen Zyklus vom Brainstorming bis zum Abschluss, und entscheiden Sie dann, ob die erzwungene Zeremonie ihren Nutzen auf Ihrer tatsächlichen Arbeitslast verdient.

Nützliche Links

• Superpowers Repository – Quellcode, Skills und Plugin-Manifeste für jeden unterstützten Agenten
• Superpowers Marktplatz – Claude Code Marktplatz 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 – Überwachung mit isoliertem Kontext, der Mechanismus hinter subagent-driven-development
• Spechgetriebene Entwicklungs-Workflow von Anforderungen bis Code – der tool-neutrale Fünf-Phasen-Prozess, den Superpowers automatisiert
• Was ist Spechgetriebene Entwicklung? Die Spec als Quelle der Wahrheit – Konzepte und Terminologie der Kern-SDD
• Claude Code Installation und Konfiguration für Ollama, llama.cpp, Preise – installieren Sie Claude Code selbst, bevor Sie Superpowers hinzufügen