Skip to content

An agentic skills framework & software development methodology that works.

Strengthen brainstorming skill trigger and add skill priority guidance

Jesse Vincent3f725ff0d468
diff --git a/commands/brainstorm.md b/commands/brainstorm.md
index 6434578db..5e39d7f5f 100644
--- a/commands/brainstorm.md
+++ b/commands/brainstorm.md
@@ -1,5 +1,5 @@
---
-description: Interactive design refinement using Socratic method
+description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores requirements and design before implementation."
---
Use and follow the brainstorming skill exactly as written
diff --git a/skills/brainstorming/SKILL.md b/skills/brainstorming/SKILL.md
index b117ed92f..32afe223d 100644
--- a/skills/brainstorming/SKILL.md
+++ b/skills/brainstorming/SKILL.md
@@ -1,6 +1,6 @@
---
name: brainstorming
-description: Use when creating or developing, before writing code or implementation plans - refines rough ideas into fully-formed designs through collaborative questioning, alternative exploration, and incremental validation. Don't use during clear 'mechanical' processes
+description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores requirements and design before implementation."
---
# Brainstorming Ideas Into Designs
diff --git a/skills/using-superpowers/SKILL.md b/skills/using-superpowers/SKILL.md
index 64f36a1d7..f325277c6 100644
--- a/skills/using-superpowers/SKILL.md
+++ b/skills/using-superpowers/SKILL.md
@@ -57,6 +57,16 @@ These thoughts mean STOP—you're rationalizing:
| "I'll just do this one thing first" | Check BEFORE doing anything. |
| "This feels productive" | Undisciplined action wastes time. Skills prevent this. |
+## Skill Priority
+
+When multiple skills could apply, use this order:
+
+1. **Process skills first** (brainstorming, debugging) - these determine HOW to approach the task
+2. **Implementation skills second** (frontend-design, mcp-builder) - these guide execution
+
+"Let's build X" → brainstorming first, then implementation skills.
+"Fix this bug" → debugging first, then domain-specific skills.
+
## Skill Types
**Rigid** (TDD, debugging): Follow exactly. Don't adapt away discipline.