From 6c13e6d890d21bdd52dc1d0fec37274d31e0d98d Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 30 May 2026 01:11:46 +0100 Subject: [PATCH] Point sp skill at ${CLAUDE_PLUGIN_ROOT}/docs and narrow its scope Rewrite the hard-coded install paths to the portable plugin-root path, and narrow the description to single-need lookups so whole-app requests route to the new sp-stack skill. Co-Authored-By: Claude Opus 4.8 (1M context) --- plugins/document-navigator/skills/sp/SKILL.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) 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) / README.md @@ -29,9 +29,8 @@ Match natural-language intent to `@suaveplan/*` packages and extract working cod README.md src/ .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