Skip to content

Conversation

@skyvanguard
Copy link

@skyvanguard skyvanguard commented Jan 23, 2026

Summary

Fixes #345, #222, #244

Anthropic unified commands and skills in Claude Code — they're now the same thing. The three legacy slash command wrappers (/brainstorm, /write-plan, /execute-plan) became redundant and actively harmful:

  • Claude sees them in autocomplete with superpowers: prefix
  • Tries to invoke them via the Skill tool
  • Fails with disable-model-invocation error
  • Users can't distinguish between the broken command (superpowers:brainstorm) and the working skill (superpowers:brainstorming)

Changes

  • Removed commands/brainstorm.md, commands/write-plan.md, commands/execute-plan.md
  • Updated README.md "Verify Installation" section to reference skills instead of commands
  • Added breaking change entry to RELEASE-NOTES.md with migration guide

Migration for users

The underlying skills continue to work exactly as before — they trigger automatically based on context. Users who typed /superpowers:brainstorm should now use the skill name superpowers:brainstorming (or just let it trigger automatically).

Context

This follows the direction set in v4.0.2 (where disable-model-invocation: true was added as a partial fix) and the owner's comment on #345:

"This is the old /command. Anthropic changed Claude to consider /commands and skills to be the same thing. The actual skill is called brainstorming. I think we need to remove the slash commands."

Test plan

  • Verified no other files import or depend on the command files
  • Skills (brainstorming, writing-plans, executing-plans) remain unchanged
  • README correctly references skills for verification
  • RELEASE-NOTES documents the breaking change with migration path
  • Grep confirmed all references to commands are in docs/history only (RELEASE-NOTES, plans)

Summary by CodeRabbit

  • Breaking Changes

    • Legacy slash commands removed — use the corresponding skills directly; migration guidance and explicit mappings to new skill names added.
  • Documentation

    • Updated wording from "commands" to "skills" across docs and examples.
    • Removed legacy command-specific instructional content and example directives.

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai
Copy link

coderabbitai bot commented Jan 23, 2026

📝 Walkthrough

Walkthrough

Removes three legacy slash-command docs and related YAML front-matter that disabled model invocation; updates README wording to reference skills instead of commands and adds a v4.2.0 Breaking Changes section in RELEASE-NOTES with mappings from old slash commands to new skill names.

Changes

Cohort / File(s) Summary
Documentation updates
README.md, RELEASE-NOTES.md
README: changed verification phrasing from commands to skills and renamed sample skill identifiers. RELEASE-NOTES.md: added v4.2.0 Breaking Changes describing removal of legacy slash-command wrappers and migration mappings to direct skill names.
Removed legacy command docs
commands/brainstorm.md, commands/write-plan.md, commands/execute-plan.md
Deleted Markdown docs that contained YAML front-matter with disable-model-invocation: true and directive lines forcing legacy slash-command invocation; removal eliminates those wrappers and their instructions.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related issues

Possibly related PRs

Poem

🐇 I hopped through docs and nudged some text,
Old slashes gone, no flags perplexed,
Skills now named, no wrappers to chase,
Clean paths ahead in the codebase space,
🥕✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: removing legacy slash commands that conflict with the unified skills system.
Linked Issues check ✅ Passed The PR removes the disable-model-invocation directive and legacy command files, directly resolving issue #345 and enabling the brainstorm skill to function properly.
Out of Scope Changes check ✅ Passed All changes align with the stated objective: removing legacy command files, updating documentation, and adding migration guidance.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Anthropic unified commands and skills in Claude Code, making the
/brainstorm, /write-plan, and /execute-plan command wrappers redundant.
These caused `disable-model-invocation` errors when Claude tried to
invoke them via the Skill tool, confusing users.

The underlying skills (brainstorming, writing-plans, executing-plans)
continue to work and trigger automatically.

- Remove commands/brainstorm.md, write-plan.md, execute-plan.md
- Update README verify section to reference skills instead of commands
- Add breaking change entry to RELEASE-NOTES.md

Fixes obra#345
Fixes obra#222
Fixes obra#244

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@skyvanguard skyvanguard force-pushed the fix/remove-legacy-slash-commands branch from fc78199 to a18c07d Compare January 24, 2026 11:09
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@README.md`:
- Around line 53-58: Update the fenced code block in README.md to include a
language specifier to satisfy markdownlint; change the opening triple-backticks
for the block that contains the commented "Should see skills like:" lines to
"```text" so the block reading "# Should see skills like:" and the three "#
superpowers:..." lines is a fenced text block.

In `@RELEASE-NOTES.md`:
- Line 7: Replace the bolded section title "**Removed legacy slash commands**"
with a proper Markdown heading (for example "## Removed legacy slash commands"
or "### Removed legacy slash commands") so the section uses a heading token
instead of emphasis-as-heading; locate the exact bold text in RELEASE-NOTES.md
and update it to the chosen heading level to satisfy markdownlint.

Comment on lines 53 to 58
```
# Should see:
# /superpowers:brainstorm - Interactive design refinement
# /superpowers:write-plan - Create implementation plan
# /superpowers:execute-plan - Execute plan in batches
# Should see skills like:
# superpowers:brainstorming - Explores user intent, requirements and design before implementation
# superpowers:writing-plans - Create detailed implementation plan with bite-sized tasks
# superpowers:executing-plans - Execute plan in batches with review checkpoints
```
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Specify a language for the fenced block.

Markdownlint flags code fences without a language; use text for console output.

🔧 Suggested fix
-```
+```text
 # Should see skills like:
 # superpowers:brainstorming - Explores user intent, requirements and design before implementation
 # superpowers:writing-plans - Create detailed implementation plan with bite-sized tasks
 # superpowers:executing-plans - Execute plan in batches with review checkpoints
</details>

<details>
<summary>🧰 Tools</summary>

<details>
<summary>🪛 markdownlint-cli2 (0.18.1)</summary>

53-53: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

</details>

</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

In @README.md around lines 53 - 58, Update the fenced code block in README.md to
include a language specifier to satisfy markdownlint; change the opening
triple-backticks for the block that contains the commented "Should see skills
like:" lines to "```text" so the block reading "# Should see skills like:" and
the three "# superpowers:..." lines is a fenced text block.


</details>

<!-- fingerprinting:phantom:triton:eagle -->

<!-- This is an auto-generated comment by CodeRabbit -->

- Use #### heading instead of **bold** for section title
- Use fenced code block with language specifier for migration mapping

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@obra
Copy link
Owner

obra commented Jan 24, 2026

I am planning on doing something like this for the next release.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Skill superpowers:brainstorm cannot be used with Skill tool due to disable-model-invocation

2 participants