An agentic skills framework & software development methodology that works.
Remove old list-skills and skills-search tools
Jesse Vincent03b34d39428a
diff --git a/skills/getting-started/list-skills b/skills/getting-started/list-skillsdeleted file mode 100755index a825d9987..000000000--- a/skills/getting-started/list-skills+++ /dev/null@@ -1,52 +0,0 @@-#!/usr/bin/env bash-# list-skills - Show all available skill names without descriptions-# For Claude to quickly see what exists before searching-# Searches personal skills first, then core skills (personal shadows core)--set -euo pipefail--# Detect core skills directory (repo or installed location)-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"-if [[ "$SCRIPT_DIR" == *"/.claude/plugins/cache/"* ]]; then- # Installed as plugin- CORE_SKILLS_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"-else- # Running from repo- CORE_SKILLS_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"-fi--# Use PERSONAL_SUPERPOWERS_DIR if set, otherwise XDG_CONFIG_HOME/superpowers, otherwise ~/.config/superpowers-PERSONAL_SUPERPOWERS_DIR="${PERSONAL_SUPERPOWERS_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/superpowers}"-PERSONAL_SKILLS_DIR="${PERSONAL_SUPERPOWERS_DIR}/skills"--# Collect all skill paths with deduplication (bash 3.2 compatible)-seen_skills_list=""-all_skills=()--# Personal skills first (take precedence)-if [[ -d "$PERSONAL_SKILLS_DIR" ]]; then- while IFS= read -r file; do- skill_path="${file#$PERSONAL_SKILLS_DIR/}"- skill_path="${skill_path%/SKILL.md}"- if [[ -n "$skill_path" ]]; then- seen_skills_list="${seen_skills_list}${skill_path}"$'\n'- all_skills+=("$skill_path")- fi- done < <(find "$PERSONAL_SKILLS_DIR" -name "SKILL.md" -type f 2>/dev/null || true)-fi--# Core skills (only if not shadowed by personal)-while IFS= read -r file; do- skill_path="${file#$CORE_SKILLS_DIR/}"- skill_path="${skill_path%/SKILL.md}"- if [[ -n "$skill_path" ]]; then- # Skip if already seen in personal skills- echo "$seen_skills_list" | grep -q "^${skill_path}$" && continue- all_skills+=("$skill_path")- fi-done < <(find "$CORE_SKILLS_DIR" -name "SKILL.md" -type f 2>/dev/null || true)--# Sort and output-printf "%s\n" "${all_skills[@]}" | sort--exit 0diff --git a/skills/getting-started/skills-search b/skills/getting-started/skills-searchdeleted file mode 100755index 3d716e396..000000000--- a/skills/getting-started/skills-search+++ /dev/null@@ -1,127 +0,0 @@-#!/usr/bin/env bash-# skills-search - Find relevant skills using grep patterns-# Logs all searches for gap analysis (gardening skill processes the log)-# Searches personal skills first, then core skills (personal shadows core)--set -euo pipefail--# Detect core skills directory (repo or installed location)-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"-if [[ "$SCRIPT_DIR" == *"/.claude/plugins/cache/"* ]]; then- # Installed as plugin- CORE_SKILLS_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"-else- # Running from repo- CORE_SKILLS_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"-fi--# Use PERSONAL_SUPERPOWERS_DIR if set, otherwise XDG_CONFIG_HOME/superpowers, otherwise ~/.config/superpowers-PERSONAL_SUPERPOWERS_DIR="${PERSONAL_SUPERPOWERS_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/superpowers}"-PERSONAL_SKILLS_DIR="${PERSONAL_SUPERPOWERS_DIR}/skills"-LOG_FILE="${PERSONAL_SUPERPOWERS_DIR}/search-log.jsonl"--# Show usage if no arguments-if [[ $# -eq 0 ]]; then- cat <<'EOF'-Usage: skills-search PATTERN [PATTERN...]--Searches skills using grep patterns.--Examples:- skills-search 'test.*driven|TDD'- skills-search 'debug.*systematic|root.cause'- skills-search 'refactor|extract'- skills-search 'async.*test|flaky|timeout'- skills-search 'validat.*input'--The search is logged. Failed searches help identify missing skills.-EOF- exit 1-fi--# Log the search for gap analysis-timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")-query="$*"-echo "{\"timestamp\":\"$timestamp\",\"query\":\"$query\"}" >> "$LOG_FILE" 2>/dev/null || true--# Search both personal and core skills directories-# Personal skills take precedence (searched first)--# Content search: grep file contents from both locations-content_matches_personal=""-content_matches_core=""-if [[ -d "$PERSONAL_SKILLS_DIR" ]]; then- content_matches_personal=$(grep -E -r "$@" "$PERSONAL_SKILLS_DIR/" --include="SKILL.md" -l 2>/dev/null || true)-fi-content_matches_core=$(grep -E -r "$@" "$CORE_SKILLS_DIR/" --include="SKILL.md" -l 2>/dev/null || true)--# Filename search: find all SKILL.md paths, then grep the paths themselves-all_skills_personal=""-all_skills_core=""-if [[ -d "$PERSONAL_SKILLS_DIR" ]]; then- all_skills_personal=$(find "$PERSONAL_SKILLS_DIR/" -name "SKILL.md" -type f 2>/dev/null || true)-fi-all_skills_core=$(find "$CORE_SKILLS_DIR/" -name "SKILL.md" -type f 2>/dev/null || true)--path_matches_personal=$(echo "$all_skills_personal" | grep -E "$@" 2>/dev/null || true)-path_matches_core=$(echo "$all_skills_core" | grep -E "$@" 2>/dev/null || true)--# Combine all matches-all_matches=$(printf "%s\n%s\n%s\n%s" "$content_matches_personal" "$content_matches_core" "$path_matches_personal" "$path_matches_core" | grep -v '^$' || true)--# Deduplicate by skill path (personal shadows core) - bash 3.2 compatible-seen_skills_list=""-results=""-while IFS= read -r file; do- # Extract skill path relative to its base directory- if [[ "$file" == "$PERSONAL_SKILLS_DIR"* ]]; then- skill_path="${file#$PERSONAL_SKILLS_DIR/}"- else- skill_path="${file#$CORE_SKILLS_DIR/}"- fi- skill_path="${skill_path%/SKILL.md}"-- # Only include if we haven't seen this skill path yet- if ! echo "$seen_skills_list" | grep -q "^${skill_path}$"; then- seen_skills_list="${seen_skills_list}${skill_path}"$'\n'- results="${results}${file}"$'\n'- fi-done <<< "$all_matches"--results=$(echo "$results" | grep -v '^$' | sort -u || true)--if [[ -z "$results" ]]; then- echo "❌ No skills found matching: $*"- echo ""- echo "Search logged. If a skill should exist, it will be created."- echo "Proceed carefully - document your approach."- exit 0-fi--echo "✅ Found skills:"-echo ""--# Display results with metadata-echo "$results" | while read -r file; do- # Extract description from frontmatter- description=$(grep "^description:" "$file" 2>/dev/null | sed 's/description: *//' || echo "")-- # Get relative path without @ prefix or /SKILL.md suffix- # Handle both personal and core skills- if [[ "$file" == "$PERSONAL_SKILLS_DIR"* ]]; then- rel_path="${file#$PERSONAL_SKILLS_DIR/}"- else- rel_path="${file#$CORE_SKILLS_DIR/}"- fi- rel_path="skills/${rel_path%/SKILL.md}"-- if [[ -n "$description" ]]; then- echo "$rel_path - $description"- else- echo "$rel_path"- fi-done--echo ""--exit 0