diff --git a/README.md b/README.md
index 0e67aefcf..dd5a7c098 100644
--- a/README.md
+++ b/README.md
@@ -44,17 +44,17 @@ Then install the plugin from this marketplace:
 
 ### Verify Installation
 
-Check that commands appear:
+Check that skills appear:
 
 ```bash
 /help
 ```
 
 ```
-# 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
 ```
 
 ### Codex
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
index cb3ad9055..ad83eaa42 100644
--- a/RELEASE-NOTES.md
+++ b/RELEASE-NOTES.md
@@ -1,5 +1,25 @@
 # Superpowers Release Notes
 
+## v4.2.0 (unreleased)
+
+### Breaking Changes
+
+#### Removed legacy slash commands
+
+Removed the three slash command files (`/brainstorm`, `/write-plan`, `/execute-plan`) that were redirecting to skills. Anthropic unified commands and skills in Claude Code, making these redundant wrappers that caused `disable-model-invocation` errors (#345, #222, #244).
+
+**Migration:** Use the skills directly — they trigger automatically based on context, or can be invoked by name:
+
+```text
+/superpowers:brainstorm    → use superpowers:brainstorming skill
+/superpowers:write-plan    → use superpowers:writing-plans skill
+/superpowers:execute-plan  → use superpowers:executing-plans skill
+```
+
+No action needed if you were already using skills directly or letting them trigger automatically.
+
+---
+
 ## v4.1.1 (2026-01-23)
 
 ### Fixes
diff --git a/commands/brainstorm.md b/commands/brainstorm.md
deleted file mode 100644
index 0fb3a8945..000000000
--- a/commands/brainstorm.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores requirements and design before implementation."
-disable-model-invocation: true
----
-
-Invoke the superpowers:brainstorming skill and follow it exactly as presented to you
diff --git a/commands/execute-plan.md b/commands/execute-plan.md
deleted file mode 100644
index c48f14005..000000000
--- a/commands/execute-plan.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-description: Execute plan in batches with review checkpoints
-disable-model-invocation: true
----
-
-Invoke the superpowers:executing-plans skill and follow it exactly as presented to you
diff --git a/commands/write-plan.md b/commands/write-plan.md
deleted file mode 100644
index 12962fd78..000000000
--- a/commands/write-plan.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-description: Create detailed implementation plan with bite-sized tasks
-disable-model-invocation: true
----
-
-Invoke the superpowers:writing-plans skill and follow it exactly as presented to you