Description

The using-superpowers skill's flow diagram references "Invoke brainstorming skill" as plain text without specifying the fully qualified skill name. This causes Claude to intermittently invoke Skill("brainstorm") or Skill("brainstorming") instead of Skill("superpowers:brainstorming"), resulting in an "Unknown skill" error.

Reproduction

1. Start a new Claude Code session with superpowers plugin enabled
2. Enter plan mode (or trigger the brainstorming flow)
3. Claude reads the flow diagram in skills/using-superpowers/SKILL.md:

   "Already brainstormed?" -> "Invoke brainstorming skill" [label="no"];

4. Claude interprets "Invoke brainstorming skill" and sometimes calls:
   • Skill("brainstorm") → Error: Unknown skill
   • Skill("brainstorming") → Error: Unknown skill
   • Skill("superpowers:brainstorming") → Success (intermittent)

Root Cause

1. Ambiguous instruction: The flow diagram says "Invoke brainstorming skill" without the superpowers: namespace prefix
2. Name collision: The deprecated commands/brainstorm.md file still exists, adding confusion between brainstorm (command) and brainstorming (skill)
3. Non-deterministic resolution: Claude's skill name inference varies between invocations, making the error intermittent

Suggested Fix

In skills/using-superpowers/SKILL.md, change the flow diagram node from:

"Invoke brainstorming skill" [shape=box];

to:

"Invoke Skill('superpowers:brainstorming')" [shape=box];

And update the edge reference accordingly. This makes the fully qualified name explicit and eliminates ambiguity.

Additionally, consider removing the deprecated command files (commands/brainstorm.md, commands/execute-plan.md, commands/write-plan.md) to reduce name collision surface.

Environment

• superpowers v5.0.6
• Claude Code CLI
• macOS