An agentic skills framework & software development methodology that works.
Update skill-run documentation and examples
Jesse Vincentaa30e861707d
diff --git a/README.md b/README.mdindex 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 Worksdiff --git a/scripts/run b/scripts/skill-runsimilarity index 74%rename from scripts/runrename to scripts/skill-runindex 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 pipefailif [[ $# -eq 0 ]]; thencat <<'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 --cleanupThe script will be found at:1. ~/.config/superpowers/<skill-relative-path> (personal, if exists)