rogee/superpowers
1
0
Fork 0
mirror of https://github.com/obra/superpowers.git synced 2026-04-25 19:19:06 +08:00
Code Issues Packages Projects Releases Wiki Activity

Add unified scripts system with find-skills and run

Browse Source 
Consolidates skill discovery and adds generic runner for cross-platform compatibility.

Changes:
- Created scripts/find-skills: Unified tool (show all + filter by pattern)
  - Shows descriptions by default
  - Searches personal first, then core (shadowing)
  - Logs searches for gap analysis
  - Bash 3.2 compatible

- Created scripts/run: Generic runner for any skill script
  - Searches personal superpowers first, then core
  - Enables running arbitrary skill scripts without CLAUDE_PLUGIN_ROOT env var
  - Example: scripts/run skills/collaboration/remembering-conversations/tool/search-conversations

- Fixed bash 3.2 compatibility in list-skills, skills-search
  - Replaced associative arrays with newline-delimited lists
  - Works on macOS default bash (3.2) and Linux bash 4+

- Updated all documentation to reference scripts/find-skills
- Removed redundant wrapper scripts

This solves the CLAUDE_PLUGIN_ROOT environment variable issue - scripts
can now be called from anywhere without needing the env var set.
This commit is contained in:
Jesse Vincent
2025-10-10 20:37:04 -07:00
parent c023e803ac
commit 16b764689a
8 changed files with 234 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
skills/getting-started/SKILL.md
View File

@@ -17,7 +17,7 @@ Personal skills shadow core skills when names match.
**RIGHT NOW**: Run this to see what skills are available:
```bash
${CLAUDE_PLUGIN_ROOT}/skills/getting-started/list-skills
${CLAUDE_PLUGIN_ROOT}/scripts/find-skills
```
**THEN**: Follow the workflows below based on what your partner is asking for.
@@ -51,17 +51,13 @@ ${CLAUDE_PLUGIN_ROOT}/skills/getting-started/list-skills
## Mandatory Workflow 2: Before ANY Task
**1. List available skills** (to avoid useless searches):
**1. Find skills** (shows all, or filter by pattern):
```bash
${CLAUDE_PLUGIN_ROOT}/skills/getting-started/list-skills
${CLAUDE_PLUGIN_ROOT}/scripts/find-skills # Show all
${CLAUDE_PLUGIN_ROOT}/scripts/find-skills PATTERN # Filter by pattern
```
**2. Search skills** (when you need something specific):
```bash
${CLAUDE_PLUGIN_ROOT}/skills/getting-started/skills-search PATTERN
```
**3. Search conversations:**
**2. Search conversations:**
Dispatch subagent (see Workflow 3) to check for relevant past work.
**If skills found:**
@@ -186,7 +182,7 @@ Your human partner's specific instructions describe WHAT to do, not HOW.
**Starting conversation?** You just read this. Good.
**Starting any task?** Run skills-search first, announce usage, follow what you find.
**Starting any task?** Run find-skills first, announce usage, follow what you find.
**Skill has checklist?** TodoWrite for every item.