About superpowers
Superpowers is a collection of agent skills for AI-assisted coding workflows, organized by development stage. It covers planning, implementation, debugging, code review, and completion, with individual skill files providing detailed guidance.
Key features
- 0114 skills across six workflow stages
- 02Brainstorming and implementation planning
- 03Test-driven development and debugging
- 04Code review and completion guidance
- 05Individual skill files and compiled AGENTS.md
Use cases
- 01Planning a new feature or project
- 02Debugging an issue systematically
- 03Applying test-first practices while coding
- 04Reviewing and integrating completed work
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/superpowersin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
AGENTS.mdrequesting-code-review/code-reviewer.mdsubagent-driven-development/code-quality-reviewer-prompt.mdimplementer-prompt.mdspec-reviewer-prompt.mdsystematic-debugging/CREATION-LOG.mdcondition-based-waiting-example.tscondition-based-waiting.mddefense-in-depth.mdfind-polluter.shroot-cause-tracing.mdtest-academic.mdtest-pressure-1.mdtest-pressure-2.mdtest-pressure-3.mdtest-driven-development/testing-anti-patterns.mdwriting-skills/anthropic-best-practices.mdgraphviz-conventions.dotpersuasion-principles.mdrender-graphs.jstesting-skills-with-subagents.mdwriting-skills/examples/CLAUDE_MD_TESTING.mdDetails
From the project READMESuperpowers - Agent Development Workflows
Comprehensive agent development skill collection optimized for AI-assisted coding workflows. Contains 14 skills across 5 categories, prioritized by workflow stage to guide development from ideation to completion.
When to Apply
Reference these skills when:
- Starting a new feature or project (brainstorming, writing-plans)
- Debugging any issue (systematic-debugging)
- Writing or modifying code (test-driven-development)
- Managing branches and isolation (using-git-worktrees)
- Completing and integrating work (finishing-a-development-branch)
- Receiving or requesting code review (receiving-code-review, requesting-code-review)
Skill Categories by Workflow Stage
| Stage | Category | Skills | Priority |
|---|---|---|---|
| 1 | Ideation & Planning | brainstorming, writing-plans | CRITICAL |
| 2 | Implementation | test-driven-development, subagent-driven-development, executing-plans | CRITICAL |
| 3 | Debugging | systematic-debugging | HIGH |
| 4 | Code Review | requesting-code-review, receiving-code-review | HIGH |
| 5 | Completion | verification-before-completion, finishing-a-development-branch | HIGH |
| 6 | Utilities | using-git-worktrees, dispatching-parallel-agents, using-superpowers, writing-skills | MEDIUM |
Quick Reference
1. Ideation & Planning (CRITICAL)
brainstorming- Collaborative design exploration before implementationwriting-plans- Create detailed implementation plans with bite-sized tasks
2. Implementation (CRITICAL)
test-driven-development- RED-GREEN-REFACTOR cycle for all codesubagent-driven-development- Execute plans with fresh subagent per taskexecuting-plans- Batch execution with checkpoints in separate session
3. Debugging (HIGH)
systematic-debugging- Four-phase root cause investigation before fixes
4. Code Review (HIGH)
requesting-code-review- Dispatch code reviewer subagent after implementationreceiving-code-review- Technical evaluation, not performative agreement
5. Completion (HIGH)
verification-before-completion- Evidence before claims, alwaysfinishing-a-development-branch- Merge, PR, keep, or discard options
6. Utilities (MEDIUM)
using-git-worktrees- Isolated workspaces for parallel developmentdispatching-parallel-agents- One agent per independent problem domainusing-superpowers- How to find and invoke skillswriting-skills- TDD applied to process documentation
Core Principles
Each skill enforces key discipline principles:
| Principle | Skills | Iron Law |
|---|---|---|
| Test First | test-driven-development | No production code without failing test |
| Root Cause First | systematic-debugging | No fixes without investigation |
| Evidence First | verification-before-completion | No claims without verification |
| Plan First | brainstorming, writing-plans | No code without design |
How to Use
Read individual skill files for detailed instructions:
brainstorming/SKILL.md
test-driven-development/SKILL.md
systematic-debugging/SKILL.md
Each skill file contains:
- Overview and core principle
- When to use (and when NOT to)
- Step-by-step process
- Common mistakes and red flags
- Integration with other skills
Full Compiled Document
For the complete guide with all skills expanded: AGENTS.md
Comments
Markdown supported