Troubleshooting

Uninstall

cd /path/to/your/project
npx superpowers-ja --uninstall

This removes installed skill directories and the superpowers-ja bootstrap sections from files such as CLAUDE.md, GEMINI.md, HERMES.md, and CONVENTIONS.md.

CLAUDE.md、GEMINI.md、HERMES.md、CONVENTIONS.md などに追加された superpowers-ja section と installed skill directories を削除します。手書きの既存 content は保持します。

Installed in Home Directory

If you accidentally installed into ~, uninstall from ~.

cd ~
npx superpowers-ja --uninstall

Then install again from the actual project directory.

cd /path/to/your/project
npx superpowers-ja

Tool Not Detected

If auto-detection does not find your AI coding tool, specify it explicitly.

npx superpowers-ja --tool claude
npx superpowers-ja --tool cursor
npx superpowers-ja --tool codex
npx superpowers-ja --tool gemini

Verify Install

ls .claude/skills
test -f .claude/skills/using-superpowers/SKILL.md

Replace .claude/skills with the install path for your tool.

Nested skills/skills After Manual Install

手動 install で skill files を copy する際、copy 先を skills/ ではなく skills/skills/ へ入れてしまうケースがあります。AI agent は skills/<skill-name>/SKILL.md を期待するため、skills/skills/<skill-name>/SKILL.md 構造だと skill が認識されません。

確認:

ls .claude/skills            # 直下に skill ディレクトリが並んでいること
test -d .claude/skills/skills && echo "nested layout detected"

skills/skills/ が出来てしまった場合は、中身を一段上に移して空 directory を削除します。scripts/audit.sh (v0.3.0 以降) はこの入れ子構造を自動検出します。

Optional Integrations

code-review-graph is not installed by superpowers-ja. Install and configure it separately only for repositories that need graph-based review.