Update skill-run documentation and examples

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

scripts/run → 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)