Give Claude Code superpowers with a comprehensive skills library of proven techniques, patterns, and workflows.
- Testing Skills - TDD, async testing, anti-patterns
- Debugging Skills - Systematic debugging, root cause tracing, verification
- Collaboration Skills - Brainstorming, planning, code review, parallel agents
- Development Skills - Git worktrees, finishing branches, subagent workflows
- Meta Skills - Creating, testing, and sharing skills
Plus:
- Slash Commands -
/superpowers:brainstorm
,/superpowers:write-plan
,/superpowers:execute-plan
- Automatic Integration - Skills activate automatically when relevant
- Consistent Workflows - Systematic approaches to common engineering tasks
Read the introduction: Superpowers for Claude Code
# In Claude Code
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
# Check that commands appear
/help
# Should see:
# /superpowers:brainstorm - Interactive design refinement
# /superpowers:write-plan - Create implementation plan
# /superpowers:execute-plan - Execute plan in batches
Brainstorm a design:
/superpowers:brainstorm
Create an implementation plan:
/superpowers:write-plan
Execute the plan:
/superpowers:execute-plan
Skills activate automatically when relevant. For example:
test-driven-development
activates when implementing featuressystematic-debugging
activates when debugging issuesverification-before-completion
activates before claiming work is done
Testing (skills/testing/
)
- test-driven-development - RED-GREEN-REFACTOR cycle
- condition-based-waiting - Async test patterns
- testing-anti-patterns - Common pitfalls to avoid
Debugging (skills/debugging/
)
- systematic-debugging - 4-phase root cause process
- root-cause-tracing - Find the real problem
- verification-before-completion - Ensure it's actually fixed
- defense-in-depth - Multiple validation layers
Collaboration (skills/collaboration/
)
- brainstorming - Socratic design refinement
- writing-plans - Detailed implementation plans
- executing-plans - Batch execution with checkpoints
- dispatching-parallel-agents - Concurrent subagent workflows
- requesting-code-review - Pre-review checklist
- receiving-code-review - Responding to feedback
- using-git-worktrees - Parallel development branches
- finishing-a-development-branch - Merge/PR decision workflow
- subagent-driven-development - Fast iteration with quality gates
Meta (skills/meta/
)
- writing-skills - Create new skills following best practices
- sharing-skills - Contribute skills back via branch and PR
- testing-skills-with-subagents - Validate skill quality
- using-superpowers - Introduction to the skills system
All commands are thin wrappers that activate the corresponding skill:
- brainstorm.md - Activates the
brainstorming
skill - write-plan.md - Activates the
writing-plans
skill - execute-plan.md - Activates the
executing-plans
skill
- SessionStart Hook - Loads the
using-superpowers
skill at session start - Skills System - Uses Claude Code's first-party skills system
- Automatic Discovery - Claude finds and uses relevant skills for your task
- Mandatory Workflows - When a skill exists for your task, using it becomes required
- Test-Driven Development - Write tests first, always
- Systematic over ad-hoc - Process over guessing
- Complexity reduction - Simplicity as primary goal
- Evidence over claims - Verify before declaring success
- Domain over implementation - Work at problem level, not solution level
Skills live directly in this repository. To contribute:
- Fork the repository
- Create a branch for your skill
- Follow the
writing-skills
skill for creating new skills - Use the
testing-skills-with-subagents
skill to validate quality - Submit a PR
See skills/meta/writing-skills/SKILL.md
for the complete guide.
Skills update automatically when you update the plugin:
/plugin update superpowers
MIT License - see LICENSE file for details