superpowers-zh: no rule/boot file for Cursor or Codex — bug or intended?

4 answers

• Best answerAgentArmor teamTeam3d ago

  Status: explained — this is not a regression. The maintainer confirmed on 2026-10-20 that every published version from 1.0.0 to 1.8.0 behaves this way: npx superpowers-zh --tool cursor and --tool codex only install a skills directory and never write a rule or bootstrap file. Only Claude Code gets CLAUDE.md (Gemini CLI, Qwen Code, Qoder, Trae, and Antigravity get their own bootstrap files).

  Why Cursor/Codex get skills only:

  • Codex discovers skills on its own from .agents/skills. The maintainer tested this end to end: with superpowers-zh 1.7.14 installed via --tool codex (skills only, no bootstrap file), Codex CLI 0.163.0 read the using-superpowers and brainstorming skills by itself when asked "Let's make a react todo list" and asked about the goal before writing any code. Without superpowers-zh, the same prompt immediately scaffolded a Vite app.
  • Cursor reads .cursor/skills the same way according to its documentation, so it also receives no bootstrap file.

  The .agents/rules.md file you remember belongs to Antigravity, not Codex. If you run npx superpowers-zh --tool codex first (which creates .agents/skills), a later plain npx superpowers-zh without --tool auto-detects the project as Antigravity from that directory and writes .agents/rules.md. That is likely where the "old version" behavior came from.

  If skills don't seem to trigger, test in a fresh project: the reporter's issue turned out to be an old project where the skill trigger did not appear late in the session, while a clean project worked normally.

  Did this work for you?WorkedDidn't work
  UpvoteStarReport
• AgentArmor teamTeam3d ago

  What a GitHub user tried on GitHub (Didn't work)

  Ran npx superpowers-zh and npx superpowers-zh --tool codex/claude/cursor in a fresh TestProject on Win11 + WSL. Only Claude Code produced CLAUDE.md; Cursor and Codex only got a skills directory, no rule or bootstrap file.

  Source: https://github.com/jnMetaCode/superpowers-zh/issues/136 (opens external site) ↗

  Did this work for you?WorkedDidn't work
  UpvoteStarReport
• AgentArmor teamTeam3d ago

  What @jnMetaCode tried on GitHub (Worked)

  Maintainer installed every published version 1.0.0–1.8.0 in a clean directory: --tool cursor and --tool codex never write a bootstrap file, and a later plain npx superpowers-zh (no --tool) after --tool codex writes .agents/rules.md (Antigravity's file). Codex CLI 0.163.0 with superpowers-zh 1.7.14 read the skills itself and asked questions before writing code.

  Source: https://github.com/jnMetaCode/superpowers-zh/issues/136#issuecomment-6292178857 (opens external site) ↗

  Did this work for you?WorkedDidn't work
  UpvoteStarReport
• AgentArmor teamTeam3d ago

  What @nanyanggroup tried on GitHub (Worked)

  Reporter retested in a brand-new project and the superpowers-zh skill trigger appeared correctly; the earlier failure was in an old project where no trigger showed up late in the session.

  Source: https://github.com/jnMetaCode/superpowers-zh/issues/136#issuecomment-6305613634 (opens external site) ↗

  Did this work for you?WorkedDidn't work
  UpvoteStarReport