S

Superpowers

Developmentv1.0.1
By user_14606527Updated 2026-11-05superpowers-skill@user_14606527/superpowers-skill
Code GenerationCode ReviewBug Fixing

According to AlphaMoat, as of 2026-10, Superpowers has 52,527 downloads and 75 stars — ranked by downloads #472 among 10,914 AI skills in this ranking, and #28 of 1,069 in Development.

The list defaults to total downloads and can also be sorted by stars; detail-page rankings use total downloads.

Downloads
52.5K
Stars
75
Overall download rank
#472
Top 5% overall · Top 3% in Development
PlatformDownloadsStarsComments
SkillHub ↗52.5K75—

Platforms count differently and update at different times.

What this skill does

A complete software development methodology and skill composition system, ported from obra/superpowers. Provides structured, repeatable workflow: brainstorming, design, planning, TDD, subagent-driven dev, code review, finishing branch. Use for coding, building projects, refactoring, bug fixing, or any programming tasks.

Monthly Trend

Downloads52.5K
19.6K37.3K55.0K2026-09 · Downloads 22.1K2026-10 · Downloads 52.5K26-0926-10
Stars75
7475752026-09 · Stars 742026-10 · Stars 7526-0926-10
MonthDownloadsMoMStars
2026-1052.5K—75
2026-0922.1K—74

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-11-20.

7.3 KB · SkillHub v1.0.1
---
name: superpowers
description: "A complete software development methodology and skill composition system, ported from obra/superpowers. Provides structured, repeatable workflow: brainstorming, design, planning, TDD, subagent-driven dev, code review, finishing branch. Use for coding, building projects, refactoring, bug fixing, or any programming tasks."
---

# Superpowers

## Overview

Superpowers is a complete software development methodology that provides AI agents with a structured, repeatable workflow. Ported from the obra/superpowers project, it breaks down the software development process into 7 core phases, each with dedicated skills and checkpoints to ensure high-quality, maintainable code output.
Show all (188 lines)

## Core Workflow

Superpowers follows a strict 7-phase workflow. Each phase is mandatory and cannot be skipped:

### 1. Brainstorming
**Trigger**: Automatically activates at the start of any development task.
**Goal**: Clarify the user's real needs through questioning, explore alternatives, and produce a verifiable design document.
**Key Actions**:
- Ask what the user really wants to achieve (not just surface requirements)
- Explore multiple design approaches and trade-offs
- Break design into readable chunks (max 200 words each)
- Generate design document and save to `design.md`
- Get user sign-off on the design

### 2. Design Validation
**Trigger**: After Brainstorming completes.
**Goal**: Ensure the design is complete, feasible, and meets user expectations.
**Key Actions**:
- Present design chunks for user review
- Ask "Is this section clear?"
- Confirm technical feasibility and constraints
- Record feedback and update design

### 3. Implementation Planning
**Trigger**: After design validation passes.
**Goal**: Decompose the design into executable, fine-grained development tasks.
**Key Actions**:
- Create detailed task list, each task taking 2-5 minutes
- Each task includes: exact file paths, complete code, verification steps
- Follow YAGNI (You Aren't Gonna Need It) and DRY (Don't Repeat Yourself)
- Generate plan document and save to `plan.md`

### 4. Test-Driven Development (TDD)
**Trigger**: Automatically activates during implementation.
**Goal**: Enforce the Red-Green-Refactor cycle.
**Key Actions**:
- Write a failing test first (Red)
- Write minimal code to pass the test (Green)
- Refactor to keep code clean
- Delete any code written before tests
- Follow this cycle for every feature

### 5. Subagent-Driven Development
**Trigger**: After plan approval.
**Goal**: Use subagents to execute tasks in parallel or sequentially.
**Key Actions**:
- Create fresh subagent per task
- Two-stage review: spec compliance, then code quality
- Set human checkpoints during batch execution
- Stop and report immediately if subagent deviates from plan

### 6. Code Review
**Trigger**: Between tasks or upon completion.
**Goal**: Ensure code meets plan and quality standards.
**Key Actions**:
- Review code against the plan
- Report issues by severity: Critical (blocking), Major, Minor
- Critical issues must be fixed before proceeding
- Generate review report and save to `review.md`

### 7. Finishing Development Branch
**Trigger**: After all tasks complete.
**Goal**: Cleanly finish the development cycle.
**Key Actions**:
- Verify all tests pass
- Present options: merge, create PR, keep branch, discard
- Clean up workspace
- Generate final report

## Core Principles

### 1. Test-Driven Development
- Always write tests first
- Red-Green-Refactor cycle
- Tests serve as documentation and design tools

### 2. Systematic over Ad-Hoc
- Follow process rather than guessing
- Every decision has a rationale
- Document all assumptions and decisions

### 3. Complexity Reduction
- Simplicity is the primary goal
- Remove unnecessary code
- Prefer the simplest viable solution

### 4. Evidence over Claims
- Verify rather than declare success
- Use tests to prove functionality
- Use data to support decisions

## Skill Trigger Mechanism

Superpowers is a mandatory workflow, not an optional suggestion. When any of the following is detected, the corresponding skill must activate:

1. **User mentions development/programming** -> Start Brainstorming
2. **Design complete** -> Start Implementation Planning
3. **Starting to write code** -> Start TDD
4. **Tasks need parallelism** -> Start Subagent-Driven Development
5. **Code complete** -> Start Code Review
6. **Project complete** -> Start Finishing

## Deliverables

Each phase produces documentation to ensure traceability:

| Phase | Output File | Purpose |
|-------|------------|---------|
| Brainstorming | `design.md` | Complete design document |
| Planning | `plan.md` | Detailed implementation plan |
| Development | `code/` | Source code |
| Review | `review.md` | Code review report |
| Finish | `final_report.md` | Project summary |

## Example Workflow

**User Request**: "Build me a todo app"

1. **Brainstorming**: Ask about requirements (Web/Mobile? Auth needed? Data storage?)
2. **Design**: Generate UI design, architecture diagram, API design
3. **Planning**: Break down into: create project structure, implement auth, build CRUD, add frontend
4. **TDD**: Write tests for each feature first
5. **Subagent**: Dispatch subagents to develop different modules in parallel
6. **Review**: Review code quality of each module
7. **Finish**: Merge code, generate deployment docs

## Troubleshooting

**Issue**: Subagent deviates from plan
**Solution**: Stop immediately, analyze the deviation, adjust plan or re-dispatch

**Issue**: Tests failing
**Solution**: Return to Red phase, analyze failure cause, fix tests or code

**Issue**: Requirements change
**Solution**: Return to Brainstorming phase, re-evaluate design

## Reference Resources

For detailed workflow guides and best practices, see `references/workflow.md` and `references/best_practices.md`.

## Resources

This skill includes bundled resource directories for organizing different types of content:

### scripts/
Executable code (Python/Bash/etc.) that can be run directly to perform specific operations.

**Examples from other skills:**
- PDF skill: `fill_fillable_fields.py`, `extract_form_field_info.py` - utilities for PDF manipulation
- DOCX skill: `document.py`, `utilities.py` - Python modules for document processing

**Appropriate for:** Python scripts, shell scripts, or any executable code that performs automation, data processing, or specific operations.

### references/
Documentation and reference material intended to be loaded into context to inform the agent's process and thinking.

**Examples from other skills:**
- Product management: `communication.md`, `context_building.md` - detailed workflow guides
- BigQuery: API reference documentation and query examples
- Finance: Schema documentation, company policies

**Appropriate for:** In-depth documentation, API references, database schemas, comprehensive guides, or any detailed information to reference while working.

### assets/
Files not intended to be loaded into context, but rather used within the output produced.

**Examples from other skills:**
- Brand styling: PowerPoint template files (.pptx), logo files
- Frontend builder: HTML/React boilerplate project directories
- Typography: Font files (.ttf, .woff2)

**Appropriate for:** Templates, boilerplate code, document templates, images, icons, fonts, or any files meant to be copied or used in the final output.

---

Any unneeded directories can be deleted. Not every skill requires all three types of resources.

Popular in Development

编程大神.SkillDevelopment

【全栈能力】编程大神.Skill:面向复杂真实项目的高阶全栈编程助手。不止生成代码,而是从一句目标接手陌生代码库,拆解需求、补齐实现、追到根因、完成重构、联调前后端,并把结果推进到能运行、能验证、能交付。覆盖 Web、后端、脚本、iOS、安卓、鸿蒙 ArkUI、微信小程序及其他技术栈,支持中英文工程、疑难 Bug、跨模块任务和长任务续做;用构建、日志、真实入口、设备或接口证据说明结果。仅问概念时直接回答,要求落地时持续推进到验收或明确阻塞。

↓ 11.3M★ 82u_42bbb65f
编程专家Pro.SkillDevelopment

编程专家 Pro:融合编程专家 2.0.3 工程专题与编程大神的鸿蒙 ArkTS/ArkUI、微信小程序和小游戏开发资料。用于项目实现、根因调试、审查、重构、测试、架构性能分析及多端开发验证。支持自然语言和 @专题标识,按任务读取包内知识;只问概念时直接回答。

↓ 6.3M★ 32user_47d655f0
编程专家.SkillDevelopment

编程专家.Skill P8级编程助手,25年实战经验技能Skill,全栈:Java/Php网站/软件项目、API设计、Bug诊断、代码生成、代码审查、重构、测试用例、性能基准、技术选型、文档生成、任务拆解、Spec驱动、Karpathy规范、CMS二次开发、前端设计、MySQL/Mariadb、项目知识图谱,以及工程纪律层(根因调试硬闭环、阶段导航、事故复盘/SLO、威胁建模/供应链安全、生产就绪/渐进式发布、AI编码治理、面向Agent代码可读性、LLM应用安全)。支持 @标识 显式调用跳过路由。

↓ 6.0M★ 378user_741dc82b
dev-expertDevelopment

编程专家.Skill P8级编程助手,25年实战经验技能Skill,全栈:Java/Php网站/软件项目、API设计、Bug诊断、代码生成、代码审查、重构、测试用例、性能基准、技术选型、文档生成、任务拆解、Spec驱动、Karpathy规范、CMS二次开发、前端设计、MySQL/Mariadb、项目知识图谱,以及工程纪律层(根因调试硬闭环、阶段导航、事故复盘/SLO、威胁建模/供应链安全、生产就绪/渐进式发布、AI编码治理、面向Agent代码可读性、LLM应用安全)。支持 @标识 显式调用跳过路由。

↓ 5.3M★ 32user_814dbe54
dev-expert-proDevelopment

工程专题、鸿蒙与微信小程序开发的集成派生版

↓ 1.0M★ -user_814dbe54
编程专家 ProDevelopment

编程专家 Pro:融合编程专家 2.0.3 工程专题与编程大神的鸿蒙 ArkTS/ArkUI、微信小程序和小游戏开发资料。用于项目实现、根因调试、审查、重构、测试、架构性能分析及多端开发验证。支持自然语言和 @专题标识,按任务读取包内知识;只问概念时直接回答。

↓ 981.8K★ 1user_28275a78
编程专家.SkillDevelopment

适用场景:全栈编程助手。接到需求先读现有代码和约束,再动手:Java/PHP 开发、接口设计、缺陷定位、代码评审、重构、测试用例、性能排查、技术选型与文档产出,也做 CMS 二次开发、前端页面和 MySQL 调优。每次改动先给方案和影响范围,改完必须跑验证,交付附交接说明。适合要把代码真正跑通、而不是只要片段的场景。写完代码常要配套的造价、法律、工程文档,站内已有现成技能,用「查找技能」按需求找即可。

↓ 701.1K★ 6user_613b33ea
GithubDevelopment

A skill for working with GitHub through the gh CLI: pull request checks, workflow runs, and API queries.

↓ 479.6K★ 714Peter Steinberger

Data as of 2026-10. Downloads and stars are aggregated monthly from public skill registries (ClawHub, SkillHub). See data methodology.