superpowers 233k+ ⭐ · 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-zh
20Skills
4China-native
18Tools
v1.6.0Version

Why superpowers-zh?

Not another prompt-template pack — real engineering methodology that makes AI work properly.

🧠

20 battle-tested methods

Not prompt templates — workflow methodology hardened by cross-session adversarial testing, from brainstorming to TDD, debugging and review.

🔌

Works in 18 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 (233k+ ⭐); 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 → review

Pick your tool, get the command

For most tools npx superpowers-zh auto-detects the project and installs; otherwise pass --tool.

npx superpowers-zh

20 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-native
chinese-code-review

Chinese review phrasing, severity tiers, and common anti-patterns in domestic teams.

Read docs →

Chinese Commit Conventions

China-native
chinese-commit-conventions

Conventional Commits adapted for Chinese, with commitlint / husky / changelog templates.

Read docs →

Chinese Documentation

China-native
chinese-documentation

CN/EN spacing, punctuation, term preservation and Chinese typography conventions.

Read docs →

Chinese Git Workflow

China-native
chinese-git-workflow

Gitee / Coding.net / JiHu GitLab / CNB access, credentials, CI and mirror sync.

Read docs →

Typical use cases

Each scenario is backed by a set of cooperating skills.

New featurebrainstorming → writing-plans → TDD

AI questions the requirements, writes a plan, then builds test-first — instead of dumping code immediately.

Fixing a bugsystematic-debugging

Forces reproduce-and-locate-root-cause before any fix — no more "guess and tweak" loops.

Before mergeverification-before-completion → code-review

Must run verification with evidence, then a review pass, before claiming "done".

CN team workflowchinese-commit-conventions → chinese-code-review

Chinese commit conventions + tiered review phrasing, wired for Gitee / Coding / JiHu GitLab.

One skill set, 18 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

FAQ

Is superpowers-zh free?
Completely free. MIT-licensed open source, forever, with no paywall or subscription.
Which AI coding tools are supported?
18 tools: Claude Code, Cursor, Windsurf, Codex CLI, Gemini CLI, Kiro, Trae, Qoder, 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 18 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.
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 removes installed skills and bootstrap files.

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.

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