SU

superpowers-workflow

A disciplined operating procedure for software tasks, enforcing planning, verification, and risk management.

Install

mkdir -p .claude/skills/superpowers-workflow && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/3172" && unzip -o skill.zip -d .claude/skills/superpowers-workflow && rm skill.zip

Installs to .claude/skills/superpowers-workflow

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Enforces a disciplined workflow for coding, debugging, refactoring, and automation: brainstorm -> plan -> implement with verification (prefer TDD) -> review -> finish. Use for almost any non-trivial change.
206 chars✓ has a “when” trigger
Beginner

Key capabilities

  • Brainstorm project goals and risks
  • Create structured implementation plans
  • Execute TDD-based development
  • Perform systematic review passes
  • Verify changes with observable checks

How it works

The skill enforces a mandatory workflow of brainstorming, planning, implementation, review, and verification to ensure disciplined software development.

Inputs & outputs

You give it
Task description or bug report
You get back
Verified code implementation

When to use superpowers-workflow

  • Implementing new features
  • Debugging complex failures
  • Refactoring existing code
  • Designing automation pipelines
  • Adding security/reliability checks

About this skill

Superpowers Workflow

This skill defines the default operating procedure for software and automation tasks.

When to use this skill

Use whenever the user asks to:

  • build or modify code
  • debug an error or failing tests
  • refactor or improve quality
  • design an automation workflow (e.g., API integrations, ETL, pipelines)
  • add tests, reliability, or safety checks

Activation marker (required)

Immediately after reading this skill (before any other output), run:

python .agent/skills/superpowers-workflow/scripts/record_activation.py --skill superpowers-workflow

Default workflow (mandatory unless explicitly unnecessary)

  1. Brainstorm (short): clarify goal, constraints, risks, and acceptance criteria.
  2. Write a plan: small steps (2–10 minutes each) with files + verification.
  3. Implement: make the smallest correct change; prefer tests-first when feasible.
  4. Review pass: correctness, edge cases, security, style, maintainability.
  5. Finish: run verification commands, summarize changes + next steps.

Decision tree: how much process is needed?

  • Tiny change (1 file, obvious):
    • Do a mini-brainstorm (3 bullets), then mini-plan (3–5 steps), then implement + verify.
  • Non-trivial change:
    • Full brainstorm + plan before editing.
  • High-risk change (auth, money, prod data, security, migrations):
    • Add explicit risk controls: rollback plan, dry-run, extra tests, logging, safe defaults.

Output rules (how you communicate)

  • Always state assumptions if anything is ambiguous.
  • Always include verification (commands, tests, or observable checks).
  • If you must ask questions, ask at most 3; then proceed with best assumptions.

Stop conditions

Pause implementation and switch to planning if:

  • requirements conflict
  • critical unknowns block correctness
  • the change could cause data loss or security issues without safeguards

When not to use it

  • Trivial tasks where process overhead exceeds work time

Prerequisites

python environment for activation script

Limitations

  • Requires activation script execution
  • Process-heavy for tiny changes

How it compares

It mandates a structured lifecycle and risk controls for non-trivial changes instead of ad-hoc coding.

Compared to similar skills

superpowers-workflow side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
superpowers-workflow (this skill)86moReviewBeginner
clojure-write163moNo flagsIntermediate
code-execution19moNo flagsAdvanced
ace-pattern-learning04moNo flagsBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

clojure-write

metabase

Guide Clojure and ClojureScript development using REPL-driven workflow, coding conventions, and best practices. Use when writing, developing, or refactoring Clojure/ClojureScript code.

1690

code-execution

mhattingpete

Execute Python code locally with marketplace API access for 90%+ token savings on bulk operations. Activates when user requests bulk operations (10+ files), complex multi-step workflows, iterative processing, or mentions efficiency/performance.

10

ace-pattern-learning

ce-dot-net

Search ACE playbook before implementing, building, fixing, debugging, or refactoring code. Capture patterns after completing substantial coding work.

00

godot

bfollington

This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.

1,0441,947

software-architecture

davila7

Guide for quality focused software architecture. This skill should be used when users want to write code, design architecture, analyze code, in any case that relates to software development.

333868

unreal-engine-cpp-pro

sickn33

Expert guide for Unreal Engine 5.x C++ development, covering UObject hygiene, performance patterns, and best practices.

43117

Search skills

Search the agent skills registry