Skip to content

An agentic skills framework & software development methodology that works.

Update skill-run documentation and examples

Jesse Vincentaa30e861707d
diff --git a/README.md b/README.md
index 9b170e833..1fe6c0701 100644
--- a/README.md
+++ b/README.md
@@ -129,16 +129,16 @@ ${CLAUDE_PLUGIN_ROOT}/scripts/find-skills 'TDD|debug' # Regex pattern
**In `scripts/` directory:**
- **find-skills** - Unified skill discovery with descriptions (replaces list-skills + skills-search)
-- **run** - Generic runner for any skill script (searches personal then core)
+- **skill-run** - Generic runner for any skill script (searches personal then core)
**Skill-specific tools:**
- **search-conversations** - Semantic search of past Claude sessions (in remembering-conversations skill)
**Using scripts:**
```bash
-${CLAUDE_PLUGIN_ROOT}/scripts/find-skills # Show all skills
-${CLAUDE_PLUGIN_ROOT}/scripts/find-skills pattern # Search skills
-${CLAUDE_PLUGIN_ROOT}/scripts/run <path> [args] # Run any skill script
+${CLAUDE_PLUGIN_ROOT}/scripts/find-skills # Show all skills
+${CLAUDE_PLUGIN_ROOT}/scripts/find-skills pattern # Search skills
+${CLAUDE_PLUGIN_ROOT}/scripts/skill-run <path> [args] # Run any skill script
```
## How It Works
diff --git a/scripts/run b/scripts/skill-run
similarity index 74%
rename from scripts/run
rename to scripts/skill-run
index 2c9651e19..35319f18f 100755
--- a/scripts/run
+++ b/scripts/skill-run
@@ -2,21 +2,20 @@
# Generic runner for skill scripts
# Searches personal superpowers first, then core plugin
#
-# Usage: scripts/run <skill-relative-path> [args...]
-# Example: scripts/run skills/collaboration/remembering-conversations/tool/search-conversations "query"
+# Usage: scripts/skill-run <skill-relative-path> [args...]
+# Example: scripts/skill-run skills/collaboration/remembering-conversations/tool/search-conversations "query"
set -euo pipefail
if [[ $# -eq 0 ]]; then
cat <<'EOF'
-Usage: scripts/run <skill-relative-path> [args...]
+Usage: scripts/skill-run <skill-relative-path> [args...]
Runs scripts from skills, checking personal superpowers first, then core.
Examples:
- scripts/run skills/collaboration/remembering-conversations/tool/search-conversations "query"
- scripts/run skills/getting-started/list-skills
- scripts/run skills/getting-started/skills-search "pattern"
+ scripts/skill-run skills/collaboration/remembering-conversations/tool/search-conversations "query"
+ scripts/skill-run skills/collaboration/remembering-conversations/tool/index-conversations --cleanup
The script will be found at:
1. ~/.config/superpowers/<skill-relative-path> (personal, if exists)