20 battle-tested methods
Not prompt templates — workflow methodology hardened by cross-session adversarial testing, from brainstorming to TDD, debugging and review.
superpowers 250k+ ⭐ · Full CN localization + China-native skills
Give your AI coding tools
superpowers that actually ship
20 battle-tested workflow skills — from brainstorming to TDD, systematic debugging to code review.
One command auto-detects your tool and installs.
$ npx superpowers-zh20Skills
4China-native
20Tools
v1.7.1Version
Why superpowers-zh?
Not another prompt-template pack — real engineering methodology that makes AI work properly.
Works in 20 tools
One skill set for Claude Code / Cursor / Codex / Gemini CLI / Windsurf and more. Switch tools, keep your habits.
One-command install
npx superpowers-zh auto-detects your tool and installs. Zero config; restart to take effect.
China-native skills
Chinese code-review phrasing, commit conventions, doc typography, and domestic Git platforms (Gitee/Coding/JiHu) — not in upstream.
Fully localized upstream
Tracks obra/superpowers (250k+ ⭐); every core skill localized into native Chinese — calibrated, not machine-translated.
Zero-dep · MIT
Pure Markdown skills. No external deps, no network, no code upload. Triggered on demand with zero runtime cost.
An end-to-end workflow, every step guarded by a skill
Skills chain together; the AI triggers the right methodology at the right moment.
1
BrainstormClarify intent before coding
→
2
PlanBreak work into steps
→
3
TDDTest first, then implement
→
4
DebugReproduce & locate first
→
5
ReviewRigorous pre-merge check
→
6
VerifyProve it with evidence
After install, AI stops "coding before thinking"
❌ Without
You: Add bulk export to the users module
AI: Sure, implementing… (starts coding)
export async function exportUsers() { … }
You: Wait — wrong format, no paging,
it OOMs on large data…✅ With superpowers-zh
You: Add bulk export to the users module
AI: First, the requirements — what format?
What data volume? Paging/streaming?
Permission checks? (triggers brainstorming)
→ plan → TDD → verify → reviewPick your tool, get the command
For most tools npx superpowers-zh auto-detects the project and installs; otherwise pass --tool.
npx superpowers-zh20 skills, covering the whole dev workflow
Click any card for the full operating doc.
Using Superpowers · Bootstrap
using-superpowers
The bootstrap skill — establishes how to discover and invoke skills at the start of every conversation.
Read docs →Brainstorming
brainstorming
Explore intent, requirements and design before any creative work — feature, component or behavior change.
Read docs →Dispatching Parallel Agents
dispatching-parallel-agents
Fan out 2+ independent tasks with no shared state or ordering dependency.
Read docs →Executing Plans
executing-plans
Execute a written plan in a separate session with review checkpoints.
Read docs →Subagent-Driven Dev
subagent-driven-development
Run a plan of independent tasks within the current session via subagents.
Read docs →Workflow Runner
workflow-runner
Run agency-orchestrator YAML workflows directly using the current session LLM — no API key.
Read docs →Writing Plans
writing-plans
Turn a spec into a step-by-step implementation plan before writing any code.
Read docs →Systematic Debugging
systematic-debugging
Reproduce and locate the root cause before proposing any fix.
Read docs →Test-Driven Development
test-driven-development
Write the test before the implementation, for every feature and bug fix.
Read docs →Verification Before Completion
verification-before-completion
Run verification and back every claim with evidence before saying it is done.
Read docs →Receiving Code Review
receiving-code-review
Apply review feedback with technical rigor — verify, don't blindly comply.
Read docs →Requesting Code Review
requesting-code-review
Validate work against requirements before merging or shipping.
Read docs →Finishing a Branch
finishing-a-development-branch
Wrap up finished work via structured merge / PR / cleanup options.
Read docs →Using Git Worktrees
using-git-worktrees
Start isolated feature work in a dedicated git worktree.
Read docs →MCP Builder
mcp-builder
Methodology for building production-grade MCP servers that connect AI to external tools.
Read docs →Writing Skills
writing-skills
Create, edit and validate skills before deploying them.
Read docs →Chinese Code Review
China-nativechinese-code-review
Chinese review phrasing, severity tiers, and common anti-patterns in domestic teams.
Read docs →Chinese Commit Conventions
China-nativechinese-commit-conventions
Conventional Commits adapted for Chinese, with commitlint / husky / changelog templates.
Read docs →Chinese Documentation
China-nativechinese-documentation
CN/EN spacing, punctuation, term preservation and Chinese typography conventions.
Read docs →Chinese Git Workflow
China-nativechinese-git-workflow
Gitee / Coding.net / JiHu GitLab / CNB access, credentials, CI and mirror sync.
Read docs →No matching skills.
Typical use cases
Each scenario is backed by a set of cooperating skills.
brainstorming → writing-plans → TDDAI questions the requirements, writes a plan, then builds test-first — instead of dumping code immediately.
systematic-debuggingForces reproduce-and-locate-root-cause before any fix — no more "guess and tweak" loops.
verification-before-completion → code-reviewMust run verification with evidence, then a review pass, before claiming "done".
chinese-commit-conventions → chinese-code-reviewChinese commit conventions + tiered review phrasing, wired for Gitee / Coding / JiHu GitLab.
One skill set, 20 tools
Switch tools without switching habits — the methodology follows you.
Claude CodeCLI
CursorIDE
WindsurfIDE
Codex CLICLI
Gemini CLICLI
KiroIDE
TraeIDE
QoderIDE
AiderCLI
OpenCodeCLI
Qwen CodeIDE
AntigravityCLI
DeerFlow 2.0Agent
VS Code · CopilotIDE
Copilot CLICLI
Hermes AgentCLI
Claw CodeCLI
OpenClawCLI
CodeBuddyIDE
CodeArtsIDE
FAQ
Is superpowers-zh free?
Completely free. MIT-licensed open source, forever, with no paywall or subscription.
Which AI coding tools are supported?
20 tools: Claude Code, Cursor, Windsurf, Codex CLI, Gemini CLI, Kiro, Trae, Qoder, CodeBuddy (Tencent), CodeArts (Huawei), Aider, OpenCode, Qwen Code, Antigravity, DeerFlow, VS Code (Copilot), Copilot CLI, Hermes Agent, Claw Code, OpenClaw.
What makes superpowers-zh unique?
A fully localized, battle-tested methodology framework for Chinese developers: brainstorming, planning, TDD, debugging, and code-review skills, plus 4 China-native skills (code review / Git workflow / docs / commit conventions), adapted for 20 AI coding tools. MIT-licensed and free forever.
How does it take effect after install?
npx installs skill files into your tool's directory (e.g. .claude/skills/). After restarting your AI tool, it auto-triggers the right skill at the right moment — no manual invocation needed.
Can I install once for all projects? (global install)
Yes. npx superpowers-zh --global installs into the tool's user-level directory (e.g. ~/.claude/skills), shared across all projects; you only re-install once to update. Project-level takes precedence, global is the fallback — they coexist. Tools with global support (all verified load paths per each tool's docs): Claude Code / Codex CLI / Qoder / Windsurf / Qwen Code / OpenClaw / OpenCode; other tools (incl. Gemini / Antigravity, which have their own global methods) should be installed per-project or via their docs.
Will it slow my AI down or upload my code?
No. Skills are on-demand Markdown: zero runtime, no network, no code or data upload — everything stays local.
How do I update or uninstall?
Update: re-run npx superpowers-zh to overwrite. Uninstall: npx superpowers-zh --uninstall for the current project; npx superpowers-zh --global --uninstall for a global install.
Pair it with the methodology for 2× efficiency
"AI Coding in Practice · The Three-Volume Methodology" — full tutorials for 10 AI coding tools plus real-world pitfalls. Online book + PDF, free forever.
Learn AI coding free · aiOlaOla ↗ Read free ↗Ready to make your AI actually ship?
One command installs 20 battle-tested skills into your tool. Free, open-source, zero-dependency.
$ npx superpowers-zh