Agent skill

Using Superpowers

by jnMetaCode in jnMetaCode/superpowers-zh

在开始任何对话时使用——确立如何查找和使用技能,要求在任何响应(包括澄清性问题)之前调用 Skill 工具. An agent skill from jnMetaCode/superpowers-zh.

MITAuto-check passedDevelopment

Install Using Superpowers

skills CLI
$ npx skills add jnMetaCode/superpowers-zh --skill using-superpowers -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jnMetaCode/superpowers-zh using-superpowers --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jnMetaCode/superpowers-zh.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/using-superpowers .claude/skills/using-superpowers && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
using-superpowers
GitHub stars
8.3k
Token cost
~679 tokens
SKILL.md length
154 words
Files
10 (incl. references)
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

在开始任何对话时使用——确立如何查找和使用技能,要求在任何响应(包括澄清性问题)之前调用 Skill 工具. An agent skill from jnMetaCode/superpowers-zh.

  • Development work in your project
  • SKILL.md covers 规则, 技能优先级, 红线 and 平台适配, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Using Superpowers is an agent skill from jnMetaCode/superpowers-zh. 在开始任何对话时使用——确立如何查找和使用技能,要求在任何响应(包括澄清性问题)之前调用 Skill 工具

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files (for example `references/antigravity-tools.md`, `references/claude-code-tools.md` and `references/codex-tools.md`).

It sits in Development. The repository describes itself as: 🦸 AI 编程超能力 · 中文增强版 — superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills,让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 26 款 AI 编程工具真正会干活. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/using-superpowers”

What it can do on your machine

Read from SKILL.md and the folder at commit fe34019. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Using Superpowers loads about 679 tokens when it runs, and up to ~7.5k if it reads all its reference files. Until then it costs about 18 tokens; SKILL.md has 154 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~18
When it runs · the whole SKILL.md, loaded when a task matches
~679
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jnMetaCode/superpowers-zh at commit fe34019, republished under its MIT licence (© jnMetaCode). 154 words, ~679 tokens.

Download SKILL.mdSave it as .claude/skills/using-superpowers/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
using-superpowers
description
在开始任何对话时使用——确立如何查找和使用技能,要求在任何响应(包括澄清性问题)之前调用 Skill 工具
version
1.0.0
license
MIT
<SUBAGENT-STOP>
如果你是作为子智能体被分派来执行特定任务的,忽略此技能。
</SUBAGENT-STOP>
<EXTREMELY-IMPORTANT>
如果你认为哪怕只有 1% 的可能性某个技能适用于你正在做的事情,你绝对必须调用该技能。

如果一个技能适用于你的任务,你没有选择。你必须使用它。

这不可协商。你不能通过合理化来逃避。 </EXTREMELY-IMPORTANT>

规则

在任何响应或操作之前调用相关或被请求的技能——包括澄清性问题、探索代码库、或查看文件之前。如果调用后发现技能不适合当前情况,你不需要使用它。

在进入 EnterPlanMode 之前: 如果你还没有头脑风暴过,先调用头脑风暴技能。

然后宣布"使用 [技能] 来 [目的]",并严格遵循该技能。如果它有检查清单,为每个条目创建一个待办。

技能优先级

当多个技能都适用时,流程技能优先——它们决定处理方式,然后由实现技能(前端设计等)负责执行。头脑风暴和系统化调试是 Superpowers 中最常见的流程技能,但这条规则适用于任何流程技能。

  • "让我们构建 X" → 先用 brainstorming,再用实现技能。
  • "修复这个 bug" → 先用 systematic-debugging,再用领域技能。

红线

这些想法意味着停下——你在合理化:

想法现实
"这只是一个简单的问题"问题就是任务。检查技能。
"我需要先了解更多上下文"技能检查在澄清性问题之前。
"让我先探索一下代码库"技能告诉你如何探索。先检查。
"我可以快速查一下 git/文件"文件缺少对话上下文。检查技能。
"让我先收集信息"技能告诉你如何收集信息。
"这不需要正式的技能"如果技能存在,就使用它。
"我记得这个技能"技能会迭代更新。阅读当前版本。
"这不算一个任务"行动 = 任务。检查技能。
"技能太小题大做了"简单的事会变复杂。使用它。
"让我先做这一件事"在做任何事之前先检查。
"这样做感觉很高效"无纪律的行动浪费时间。技能防止这一点。
"我知道那是什么意思"知道概念 ≠ 使用技能。调用它。

平台适配

如果你的运行环境在下面列出,请阅读对应的参考文件获取特殊说明:

  • Claude Code:references/claude-code-tools.md
  • Codex:references/codex-tools.md
  • Pi:references/pi-tools.md
  • Antigravity:references/antigravity-tools.md
  • Copilot CLI:references/copilot-tools.md
  • Hermes Agent:references/hermes-tools.md
  • Qoder:references/qoder-tools.md
  • Muse:references/muse-tools.md

Gemini CLI 用户通过 GEMINI.md 自动获得 references/gemini-tools.md 的工具映射。

中国特色技能路由

🇨🇳 本节是 superpowers-zh 的增量内容,上游 obra/superpowers 没有。 用于说明本 fork 原创的 chinese-* 系列 skill 何时使用。其余各节均为逐节翻译。

这 4 个 chinese-* 是参考资料,不是工作流 —— 话术模板、排版约定、平台配置差异。 它们只在用户显式调用时才加载,不要根据上下文自动触发:上下文里多一份排版参考 不会让你写得更好,只会挤掉真正需要的内容。

用户显式说加载技能里面是什么
/chinese-code-reviewchinese-code-review中文 review 话术模板、分级标注、国内团队常见反模式应对
/chinese-git-workflowchinese-git-workflowGitee / Coding.net / 极狐 GitLab / CNB 的 SSH、凭据、CI 接入差异
/chinese-documentationchinese-documentation中英文空格、全半角标点、术语保留、中文文案排版指北约定
/chinese-commit-conventionschinese-commit-conventionsConventional Commits 中文适配、commitlint / husky 中文模板

用户没点名就不要主动拉进来。反过来,用户点名了就照它执行,不要因为"看起来只是格式问题" 而跳过。

它们与翻译技能叠加使用,不互斥:用户要求做中文 review 时,是 requesting-code-review(流程)加上 chinese-code-review(风格),不是二选一。

这个「只在显式调用时加载」是刻意决定,不是漏写(见 commit 392ff75)。改动它需要 eval 证据 —— 参见 PR #123 与本仓 CLAUDE.md「Skill 改动需要 eval」。

用户指令

用户指令(CLAUDE.md、AGENTS.md、GEMINI.md 等、直接请求)优先于技能,技能又优先于默认行为。只有当你的人类伙伴明确告诉你跳过时,才能跳过技能工作流或指令。

© jnMetaCode, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (references) in skills/using-superpowers of jnMetaCode/superpowers-zh.

  • SKILL.md
  • references/antigravity-tools.md
  • references/claude-code-tools.md
  • references/codex-tools.md
  • references/copilot-tools.md
  • references/gemini-tools.md
  • references/hermes-tools.md
  • references/muse-tools.md
  • references/pi-tools.md
  • references/qoder-tools.md

Open the folder on GitHubat commit fe34019

Compare with similar skills

Using Superpowers next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Using Superpowers compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Using Superpowers this skilljnMetaCode/superpowers-zh8.3k—~679Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k24 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
Greplooponyx-dot-app/onyx32k4 repos~3.3kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 24 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed
  • Guidelines

    akash-network/node

    Behavioral guidelines to reduce common LLM coding mistakes. An agent skill from akash-network/node.

    1.1k GitHub starsUsed in 22 repos~577 tokens
    DevelopmentAuto-check passed

More from jnMetaCode/superpowers-zh

All 21 skills in this repo
  • Brainstorming Before Building

    jnMetaCode/superpowers-zh

    Turns a rough idea into an approved design before any code is written, sorting the request into spike, bounded or architectural and enforcing an approval gate.

    8.3k GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • Git Worktree Isolation

    jnMetaCode/superpowers-zh

    Sets up an isolated workspace before feature work or plan execution, preferring native worktree tools and falling back to git worktree, with instructions in Chinese.

    8.3k GitHub starsUsed in 1 repo~982 tokens
    Auto-check passed
  • Inline Plan Execution

    jnMetaCode/superpowers-zh

    Executes a written implementation plan task by task in the current session, with a progress ledger, test-first gates and one fresh-context review at the end.

    8.3k GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Agency Orchestrator Workflow Runner

    jnMetaCode/superpowers-zh

    Runs agency-orchestrator YAML workflows inside the current agent session, with the session's own model playing each role in turn and no API key needed.

    8.3k GitHub starsUsed in 1 repo~885 tokens
    Auto-check passed
  • Chinese Code Review Etiquette

    jnMetaCode/superpowers-zh

    Gives Chinese-language templates and priority labels for code review feedback, plus guidance on bilingual comments, commit messages and common team anti-patterns.

    8.3k GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • Chinese Commit Conventions

    jnMetaCode/superpowers-zh

    Reference for Chinese-language git commits and changelogs: Conventional Commits adapted for Chinese teams, with templates, breaking-change notes and issue links for several platforms.

    8.3k GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Using Superpowers

What does Using Superpowers do?

在开始任何对话时使用——确立如何查找和使用技能,要求在任何响应(包括澄清性问题)之前调用 Skill 工具. An agent skill from jnMetaCode/superpowers-zh. Using Superpowers is an agent skill from jnMetaCode/superpowers-zh.

When should I use Using Superpowers?

Using Superpowers fits situations like: development work in your project.

How do I install Using Superpowers in Claude Code?

Run `npx skills add jnMetaCode/superpowers-zh --skill using-superpowers -a claude-code`. Or copy the skill folder (skills/using-superpowers in jnMetaCode/superpowers-zh) into .claude/skills/using-superpowers in your project. Claude Code loads it when a task matches its description.

How do I install Using Superpowers in Codex?

Run `npx skills add jnMetaCode/superpowers-zh --skill using-superpowers -a codex`. Or copy the skill folder (skills/using-superpowers in jnMetaCode/superpowers-zh) into .agents/skills/using-superpowers in your project. Codex loads it when a task matches its description.

Can I use Using Superpowers in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jnMetaCode/superpowers-zh --skill using-superpowers -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/using-superpowers, .gemini/skills/using-superpowers, .github/skills/using-superpowers and .opencode/skills/using-superpowers in your project.

What does Using Superpowers need to run?

SKILL.md names no scripts, command-line tools or credentials: Using Superpowers is instructions for the agent only.

Does Using Superpowers access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Using Superpowers safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Using Superpowers use?

Using Superpowers is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Using Superpowers use?

About 679 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6.8k tokens, read only when the agent opens those files.

What are the alternatives to Using Superpowers?

Skills that share tags, products or a category with Using Superpowers: Finishing a Development Branch (obra/superpowers, 296k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars) and Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Using Superpowers?

jnMetaCode (a GitHub user) maintains it in jnMetaCode/superpowers-zh, which has 8,265 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 4, 2026.

Source: jnMetaCode/superpowers-zh on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.