Superpowers Quickstart: Installation, Workflow und Test

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

Die meisten Claude Code SDD-Setups scheitern auf die gleiche Weise: Jemand schreibt ein solides specify-plan-implement-Skill einmal, verwendet es eine Woche lang gewissenhaft, gleitet dann aber beim ersten Näherrücken einer Deadline still und leise wieder zu unstrukturiertem Prompting zurück. In einem selbst geschriebenen Skill steckt nichts, was das tatsächlich verhindert. Superpowers ist eine direkte Antwort auf dieses Disziplinproblem – ein Skill-Paket, entwickelt von Jesse Vincent und dem Team bei Prime Radiant, das Brainstorming, Planung, Subagent-Review und red-green-refactor TDD als obligatorische Schritte behandelt, die der Agent vor jeder Aufgabe prüft, anstatt optionale Vorschläge, die er unter Druck überspringen kann.

Was es lohnenswert macht, es nicht nur als Fußnote, sondern mit einer eigenen Aufmerksamkeit zu betrachten, 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 mit. So folgt dieselbe Methodik Ihnen über verschiedene Harness hinweg, anstatt nur in einem .claude/skills/-Ordner eines einzelnen Repos zu leben. Dieser Leitfaden behandelt, was es tatsächlich ist, wie Sie es auf dem Agenten installieren und verifizieren, den Sie verwenden, wie ein erster End-to-End-Durchlauf aussieht und wo es neben anderen spezifikationsteilgesteuerten Entwicklungstools einordnet wird.

Was ist Superpowers?

Superpowers beschreibt sich selbst als „eine vollständige Softwareentwicklungs-Methode für Ihre Coding-Agenten, die auf einer Reihe kombinierbarer Skills und einigen anfänglichen Anweisungen aufbaut, die sicherstellen, dass Ihr Agent sie verwendet“. Letzter Teil ist der entscheidende. Es gibt viele Skill-Sammlungen; der Unterscheidungspunkt hier ist die Bootstrap-Anweisung, die den Agenten zwingt, vor dem Start jeder 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 offen dargelegt:

• Testgetriebene Entwicklung (TDD) – Tests zuerst schreiben, immer
• Systematisch statt Ad-hoc – Prozess statt Raten
• Komplexitätsreduktion – Einfachheit als Hauptziel
• Beweise statt Behauptungen – Verifizieren, bevor man Erfolg verkündet

In der Praxis zeigt sich diese Philosophie als eine Abfolge von Skills, die das Zepter aneinander weitergeben. Wenn Sie Claude Skills and SKILL.md for Developers 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 etwas, das Sie selbst verfassen.

Superpowers über Coding-Agenten hinweg installieren

Die Installation ist harnessspezifisch, und das Projekt legt ausdrücklich fest, dass Sie es für jeden Agenten, den Sie verwenden, separat installieren – es gibt keine einzelne globale Installation.

Claude Code

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

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

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

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

Cursor

/add-plugin superpowers

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

Andere 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 es mit demselben Befehl neu, um es zu aktualisieren.
• Pi lädt die Skills über eine kleine Erweiterung, die die using-superpowers-Bootstrap-Anweisung beim Session-Start und nach der Kontext-Kompaktion injiziert, und benötigt das Kompatibilitäts-Skill-Tool von Pi nicht, da Pi eine native Skill-Unterstützung hat.
• Hermes Agent hat keinen Post-Kompaction-Hook – eine sehr lange Session, die über ihren ersten Turn kompaktiert wird, kann die Bootstrap-Anweisung verlieren, also starten Sie eine neue Session, wenn die Skills nicht mehr ausgelöst werden.
• OpenCode behandelt dies als einen völlig separaten Installationspfad von jedem anderen Harness, den Sie bereits verwenden, auch auf demselben Computer.

Installation überprüfen

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 in den Ergebnissen auflisten. Dies ist dieselbe Entdeckungsprüfung, die für die Fehlersuche bei 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: Von Brainstorming bis zum versandten Code

Superpowers dokumentiert sieben Skills als „den Basis-Workflow“, wobei jedes an einem spezifischen 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 Chunks anstatt einem langen Dokument – und speichert das Ergebnis dann 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, handliche Aufgaben – Superpowers zielt auf zwei bis fünf Minuten Arbeit pro Aufgabe – mit exakten Dateipfaden, vollständigem Code, wo relevant, und expliziten Verifizierungsschritten.
4. subagent-driven-development (schnelle Iteration) oder executing-plans (Batch-Ausführung mit menschlichen Checkpoints) entsendet einen neuen Subagenten pro Aufgabe, mit einer zweistufigen Prüfung: zunächst Spezifikationskonformität, dann Code-Qualität.
5. test-driven-development erzwingt strenges red-green-refactor – einen fehlschlagenden Test schreiben, beim Scheitern zusehen, den minimalen Code zum Bestehen schreiben, beim Bestehen zusehen, committen. Code, der vor dem Existieren eines fehlschlagenden Tests für ihn geschrieben wurde, wird gelöscht, nicht behalten.
6. requesting-code-review wird zwischen Aufgaben aktiviert, prü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, präsentiert dann Optionen – mergen, ein PR öffnen, den Branch behalten oder verwerfen – und räumt den Worktree auf.

Dies entspricht eng der toolneutralen Fünf-Phasen-Schleife in Spec-Driven Development Workflow From Requirements to Code: specify wird zu brainstorming, plan zu writing-plans, tasks und implement fließen in subagent-driven-development ein, und validate wird auf TDD und Code-Review aufgeteilt. Der Unterschied liegt in der Erzwingung – Superpowers ist so konstruiert, 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 nicht bei der ersten Ausführung auf Ihr wichtigstes Feature. Wählen Sie etwas Echtes, aber Begrenztes – einen kleinen Endpunkt, einen fokussierten Bugfix, eine einzelne Modul-Refactor – und starten Sie eine Session in einem Projekt, das bereits eine Test Suite hat, da die TDD-Erzwingung dort am sichtbarsten ist.

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

Mit installiertem Superpowers dürfen Sie erwarten, dass die Session mit Brainstorming-Fragen beginnt und nicht mit Code: welche Endpunkte, welche Grenze, pro Benutzer oder pro Schlüssel, was passieren sollte, wenn die Grenze erreicht wird. Dieser Widerstand ist beabsichtigt – es ist dieselbe Nicht-Ziele-Disziplin, die in Spezifikationsteilgesteuerter Entwicklungsworkflow von Anforderungen bis zum Code behandelt wird, nur dass sie hier vom Skill erzwungen wird, anstatt Ihnen überlassen zu sein, es sich zu merken. Sobald Sie das Design in Chunks genehmigen, erwarten Sie einen Plan mit nummerierten, kleinen Aufgaben, bevor Dateiänderungen vorgenommen werden, dann einen Subagenten pro Aufgabe mit einem Diff, den Sie an jedem Checkpoint prüfen.

Zwei Dinge, auf die Sie bei einer ersten Ausführung achten sollten:

• Bestätigen Sie, dass TDD tatsächlich erzwungen wird. Bitten Sie den Agenten, eine Aufgabe zu implementieren, und prü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 durchzufü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, lohnt es sich, dies während des writing-plans-Review-Checkpoints anzubringen, nicht im Nachhinein.

Was drin ist: Die Skills-Bibliothek

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

dispatching-parallel-agents verdient besondere Erwähnung: Es behandelt parallele Subagenten-Workflows, was denselben Bereich abdeckt wie Claude Code Subagents – isolierter Kontext, unabhängiges Review und eine Zusammenfassung, die an die Haupt-Session zurückgemeldet wird, anstatt sie mit Zwischenoutput zu überschwemmen.

Wann Superpowers passt (und wann nicht)

Gute Passung:

• Sie mögen bereits den Ansatz von Claude Code Skills für Spezifikationsteilgesteuerte Entwicklung vs Vibe Coding, gleiden aber ständig zu unstrukturiertem Prompting zurück, weil nichts die Review-Gates erzwingt.
• Sie arbeiten mit mehreren Coding-Agenten und möchten eine Methodik, die mit Ihnen mitreist, anstatt nur ein Claude-Code-spezifisches Skill.
• Sie möchten strenge TDD-Erzwingung, ohne die Erzwingungslogik selbst zu schreiben.
• Multi-Session-Features, bei denen architektonische Drift und vergessene Einschränkungen ein reales Risiko darstellen – genau das Versagen-Muster, das in Spezifikationsteilgesteuerter Entwicklung vs Vibe Coding beschrieben wird.

Schwächere Passung:

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

Wie Superpowers sich von anderen SDD-Tools unterscheidet

Superpowers ist im gewöhnlichen Sinne kein Wettbewerber von GitHub Spec Kit oder AWS Kiro – es operiert auf der Claude Code / Cross-Agent Skills-Ebene, anstatt als eigenständiges 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 geschriebenes Claude Code Skill bietet Ihnen maximale Flexibilität ohne Erzwingung. Superpowers liegt zwischen den letzten beiden: derselbe skillsbasierte Mechanismus wie ein DIY Claude Code Workflow, aber mit sich als obligatorisch fühlender Erzwingung und cross-agent Plugin-Distribution, die ein repo-lokales Skill nicht bereitstellt.

Für die vollständige Aufschlüsselung von Portabilität, Setups-Friction, Review-Gates und Lock-in über Spec Kit, Kiro, Claude Code Skills, OpenSpec, BMAD-METHOD und Tessl hinweg – einschließlich, wo Superpowers in der Vergleichstabelle und im Entscheidungsrahmen landet – siehe GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows. Wenn Sie weniger erzwungene Zeremonie und mehr Freiheit möchten, auf einer Brownfield-Codebasis zu iterieren, behandelt der OpenSpec Quickstart die leichtere, änderungszentrierte Alternative.

Fehlerbehebung und Dinge zu wissen

Updates sind größtenteils automatisch, aber agentenabhängig. Wie aktuell Ihre Installation bleibt, hängt vom Harness ab – Antigravity führt den Session-Start-Hook bei Neuirnstanlation 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 jeden wahrheitswerten Wert, um es auszuschalten. Superpowers respektiert 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, forken Sie das Repository, wechseln Sie zu dev und befolgen Sie das writing-skills-Skill für das Erstellen und Testen von Änderungen – neue Skill-Beiträge werden spezifisch im Allgemeinen nicht akzeptiert, da jedes Skill identisch über alle unterstützten Agenten hinweg funktionieren muss.

Wenn ein Skill nicht auslöst, 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 aktuell verwenden (nicht einen anderen auf demselben Computer), und denken Sie daran, dass Hermes-Sessions nach der Kompaktion einer langen Session einen frischen Start benötigen, wenn die Bootstrap-Anweisung still wegfällt.

Fazit

Superpowers ist die Installation wert, wenn die Lücke zwischen Ihren SDD-Intentionen 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 Loop wird bereits gut durch Was ist Spezifikationsteilgesteuerte Entwicklung? abgedeckt – es macht eine bestehende Idee schwerer zu überspringen, und es tut das auf mehr Agenten, als ein repo-lokales Skill erreichen kann. Installieren Sie es zuerst auf dem Harness, das Sie täglich verwenden, führen Sie eine kleine, begrenzte Aufgabe durch den kompletten Zyklus von Brainstorming bis zum Abschluss, und entscheiden Sie dann, ob die erzwungene Zeremonie ihren Wert auf Ihrer tatsächlichen Arbeitslast rechtfertigt.

Nützliche Links

• Superpowers repository – Quellcode, Skills und Plugin-Manifeste für jeden unterstützten Agenten
• Superpowers marketplace – 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 and SKILL.md for Developers – die zugrunde liegenden Skill-Mechaniken, auf denen Superpowers aufbaut
• Claude Code Subagents: Setup, Config, and When to Use Them – Review mit isoliertem Kontext, der Mechanismus hinter subagent-driven-development
• Spec-Driven Development Workflow From Requirements to Code – der toolneutrale Fünf-Phasen-Prozess, den Superpowers automatisiert
• What Is Spec-Driven Development? The Spec as Source of Truth – Kernkonzepte und Terminologie der SDD
• Claude Code install and config for Ollama, llama.cpp, pricing – Installieren Sie Claude Code selbst, bevor Sie Superpowers hinzufügen