diff --git a/plugins/document-navigator/skills/sp/SKILL.md b/plugins/document-navigator/skills/sp/SKILL.md
index 41c0dc5..2d7b1d7 100644
--- a/plugins/document-navigator/skills/sp/SKILL.md
+++ b/plugins/document-navigator/skills/sp/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: sp
-description: Navigate the 500+ @suaveplan/* packages to find libraries matching a stated development need. Extracts code examples from the mirrored docs tree.
+description: Find the @suaveplan/* package for a single stated need ("which library does X", "how do I use Y") and extract its code examples from the docs tree. For whole-app stacks, use sp-stack.
 ---
 
 # Document Navigator for Suaveplan
@@ -13,13 +13,13 @@ Match natural-language intent to `@suaveplan/*` packages and extract working cod
 |-------|--------|
 | User intent | Natural language via `/sp` or direct invocation |
 | Package index | `packages/README.md` → category READMEs → subcategory READMEs → package READMEs |
-| Docs tree | `.claude/plugins/suaveplan-skills/docs/` (`.md`-only mirror of `packages/`, maintained externally) |
+| Docs tree | `${CLAUDE_PLUGIN_ROOT}/docs/` (`.md`-only mirror of `packages/`, maintained externally) |
 | Examples | Linked `.md` files inside each package (`src/**/*.md`) |
 
 ## File Structure
 
 ```
-.claude/plugins/suaveplan-skills/
+${CLAUDE_PLUGIN_ROOT}/
   docs/                          # mirrored .md tree (maintained externally)
     <category>/
       README.md
@@ -29,9 +29,8 @@ Match natural-language intent to `@suaveplan/*` packages and extract working cod
           README.md
           src/
             <module>.md
-  plugins/document-navigator/
-    skills/sp/
-      SKILL.md                   # this file
+  skills/sp/
+    SKILL.md                     # this file
 ```
 
 ## Patterns
@@ -40,10 +39,10 @@ Match natural-language intent to `@suaveplan/*` packages and extract working cod
 
 ```bash
 # Search package names and descriptions
-grep -ri "sms" .claude/plugins/suaveplan-skills/docs/*/README.md
+grep -ri "sms" ${CLAUDE_PLUGIN_ROOT}/docs/*/README.md
 
 # Search all module documentation
-grep -ri "twilio" .claude/plugins/suaveplan-skills/docs/
+grep -ri "twilio" ${CLAUDE_PLUGIN_ROOT}/docs/
 ```
 
 ### Traversing the hierarchy