mrkeyoor.com_
Thu 17 Sept 15:59 UTC
AI Toolsevaluationupdated 17 Sept 2026

superpowers-zh review

superpowers-zh is a primarily Simplified Chinese package of working instructions for AI coding agents, with translated upstream skills and China-specific additions. The README links English readers to obra/superpowers, but it does not present the added Chinese skills and 26-tool installation guidance as a complete English edition.

Verdict

Our superpowers-zh install finished in 3 seconds with 0 packages added, but commit 78cb4f6 exposed no build or test target for us to run. Chinese-speaking developers who use several coding agents get a practical installer and 20 skills, while English-only teams should start with the upstream project. Pin a version and check the adapter for your chosen tool before rolling it across a team.

We ran it

Lab card: what happened when we ran superpowers-zhScreenshot of superpowers-zh (sp.aiolaola.com)
Install✓ · 3s0 packages · 4 MB
Buildn/ano build script
Testsn/ano test script
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo212 files~13,714 lines of source · 2 MB · 3 CI workflows · tests dir

Answers from our run

Does superpowers-zh build from source?

Dependencies installed in 3 seconds (0 packages), and the project has no separate build step. We cloned commit 78cb4f6 into a clean Debian container with 3 CPUs and no project-specific setup.

Does superpowers-zh have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does superpowers-zh have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use superpowers-zh?

English-only teams that need the fork's extra material: the README sends English readers to the upstream project, while the China-specific skills are documented in Chinese.

What are the alternatives to superpowers-zh?

Superpowers, Anthropic Skills, Trail of Bits Skills. Our superpowers-zh install finished in 3 seconds with 0 packages added, but commit 78cb4f6 exposed no build or test target for us to run.

Setup4/53-second install, but it writes tool-specific project files
Docs4/5Detailed Chinese routes for 26 tools; additions lack full English docs
Community4/58,142 stars and same-day issue activity on September 17
Maturity3/5Wide adapter support, with no declared test target in our run

Who it’s for

Chinese-speaking developers who want the Superpowers workflow inside Claude Code, Codex, Cursor, OpenCode, or another listed coding agent.
Teams using Gitee, Coding, CNB, or Chinese commit and documentation conventions.
Developers who want one npm installer to place skills and bootstrap files for several agent tools.
Skill authors who want Chinese examples for planning, TDD, debugging, review, and MCP server work.

Who it’s NOT for

English-only teams that need the fork's extra material: the README sends English readers to the upstream project, while the China-specific skills are documented in Chinese.
Teams that require every adapter to track upstream immediately: issue 131 reports that the OpenCode mapping still teaches @mention after upstream replaced it with the callable task tool.
Projects whose acceptance gate requires a declared npm test command: our checkout contained a tests directory but exposed no test script or target.
Codex users who require native marketplace installation today: issue 129 says the required marketplace entry is missing and documents the npm installer as the working route.
Developers expecting a read-only content bundle: the full installer writes skill directories, bootstrap files, and hooks into the chosen project or user configuration.

Setup reality

Our sandbox installed commit 78cb4f6 in 3 seconds, added 0 packages, and used 4 MB on disk. The 2 MB checkout held 212 files and about 13,714 source lines. No build or test script was declared, so both steps were skipped; npm audit found 0 known vulnerabilities.

The normal route needs Node and npm plus one of the supported coding tools. The package itself does not ask for a model credential during installation, though the target coding agent has its own account or provider setup.

Project and global installs write to different tool-specific directories. A manual copy omits hooks and bootstrap generation, while duplicate Claude Code installation can leave two skill copies. Codex native marketplace support was still an open request in issue 129.

Twenty Chinese skills cover 26 coding tools

superpowers-zh packages a development method for AI coding agents, written primarily for Chinese-speaking developers. Its README counts 20 skills: 14 translations from obra/superpowers, 4 original Chinese additions, and 2 upstream skills that this fork kept after their removal. The subjects include requirements discussion, planning, test-driven development, debugging, code review, worktrees, and verification before completion. This is instruction content for an agent, not a model or coding service.

The larger distinction is distribution. The project documents 26 agent tools and editors, ranging from Claude Code and Codex to Cursor, Windsurf, OpenCode, Qwen Code, and several China-focused products. One npx superpowers-zh command detects supported project markers and writes each tool's expected skill layout. That saves repeated path hunting when a team uses several assistants, though a long compatibility table also creates more surfaces that can drift.

The installer writes skills, bootstrap files, and hooks

The recommended npm route installs at project level by default. Version 1.7.0 added a global mode for tools with documented user directories, such as Claude Code's user skills and Codex's .agents/skills path. The installer may also generate files such as CLAUDE.md, GEMINI.md, or tool-specific rules. You should review the diff after running it in an existing repository because these files influence every later agent session.

Several guardrails are documented. Since v1.2.1, project installation refuses to run from the home directory by default, and generated additions use sentinel comments so the uninstaller can remove its own sections. The README also warns against installing the Claude Code package twice through npm and the plugin marketplace. Manual copying is described as a reduced mode because it omits bootstrap generation and hooks, leaving users to invoke skills themselves.

What happened when we ran it

Our sandbox installed commit 78cb4f6 in 3 seconds. Npm added 0 packages and the result occupied 4 MB, so trying the repository itself is cheap. The checkout was 2 MB with 212 files and about 13,714 lines of source. Npm audit reported 0 known vulnerabilities: 0 critical, 0 high, 0 moderate, and 0 low in the dependency state we measured.

There was no build script or target, so we skipped the build rather than inventing a command. The repository also declared no test script or target, and our test step was skipped even though the checkout contains a tests directory. That distinction matters. Three CI workflow files show that the maintainers automate checks, but a contributor cannot infer a standard local test command from the npm scripts our harness inspected. No Dockerfile was present, which is unsurprising for an installer and skill collection.

OpenCode's v1.18.31 mapping shows the cost of 26 adapters

Open issue 131 gives the clearest maintenance warning. The reporter tested OpenCode v1.18.31 and found that the injected mapping tells an agent to use @mention for subagents. In that interface, @mention is a user-side control rather than a callable model tool; the report says the agent should receive task with a subagent type. It also traces the corrected behavior to upstream changes that had not reached the fork's OpenCode plugin and documentation.

Other rough spots are narrower but relevant to the fork's promise. Issue 116 says files produced by the subagent-driven-development skill came out in English instead of Chinese. Issue 129 says Codex's native plugin marketplace cannot discover this repository because a marketplace file is absent, although npx superpowers-zh --global --tool codex remains available. The README's v1.7.12 notes also describe 32 broken cross-skill references fixed for Claude Code plugin users, evidence that adapter behavior needs regression checks.

English covers the upstream, while 6 fork-specific skills stay Chinese

The README offers an English link to obra/superpowers rather than a parallel English edition of all 20 skills. That works for the 14 translated skills because readers can consult their original source. It does not give English-only teams the same path through the 4 China-specific skills or the 2 retained upstream skills as maintained here. This language choice is sensible for the audience, but it is a real boundary, not a cosmetic translation setting.

Those additions are the reason to choose the fork. They cover Chinese code-review tone, Git platforms, technical writing, and commit conventions, while the retained material includes an MCP builder and a YAML workflow runner. The four China-specific skills require explicit invocation, according to the README, which keeps them from firing inside unrelated work. Teams should sample their own pull requests and agent transcripts before making the package a shared default, especially when prompts cross Chinese and English.

A September 17 push matters more than the July release tag

GitHub recorded 8,142 stars, 14 combined open issues and pull requests, and a last push on September 17, 2026. The latest GitHub release was v1.7.1 from July 17, while the README already described v1.7.12 changes and the open Codex request mentioned v1.7.13. That mismatch does not show abandonment. It says the GitHub release page is a poor sole source for choosing the current npm package version.

Use superpowers-zh when the working language is Chinese and the same development habits need to follow people across several agent tools. The 3-second install and zero installed dependencies make a trial easy. The missing declared test target and current adapter reports make a fleet-wide unpinned install harder to defend. Start in one repository, inspect every generated file, run a real task in the chosen agent, and promote the exact version that produced acceptable behavior.

Alternatives

ProjectWhat it isPick it when
Superpowers gh↗The English upstream agent-skills framework and development method.pick this instead when English documentation and direct upstream behavior matter more than Chinese tooling and conventions.
Anthropic Skills gh↗Anthropic's public collection of Agent Skills and examples.pick this instead when you want official skill examples without this fork's installer and prescribed development workflow.
Trail of Bits Skills gh↗A security-focused skill collection for audits and vulnerability research.pick this instead when the agent's main job is security analysis rather than a general software-development method.

What people are saying

  1. [github-trending] jnMetaCode/superpowers-zh

Sources

  1. superpowers-zh repository and README
  2. superpowers-zh v1.7.1 release
  3. OpenCode tool mapping report
  4. Codex native marketplace request
  5. Chinese output report for subagent briefs
  6. English upstream Superpowers project

More ai tools reviews

rowboat · skills · yolov5 · eve · MemOS · LongCat-Video · the whole board →