bigpowers 2.43.4 → 2.44.0

package/scripts/audit-catalog.sh

@@ -7,21 +7,24 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 cd "$REPO_ROOT"
+# SKILLS_ROOT: use skills/ when it exists, fall back to repo root
+SKILLS_ROOT="$REPO_ROOT"
+[[ -d "$REPO_ROOT/skills" ]] && SKILLS_ROOT="$REPO_ROOT/skills"
 
 ORPHANS=()
 MISSING=()
 
-# Check: every .pi/skills/<name>/ dir must have a matching <name>/SKILL.md source
+# Check: every .pi/skills/<name>/ dir must have a matching source SKILL.md
 for d in .pi/skills/*/; do
   name=$(basename "$d")
-  if [ ! -f "$name/SKILL.md" ]; then
+  if [ ! -f "$SKILLS_ROOT/$name/SKILL.md" ]; then
     ORPHANS+=("$name")
   fi
 done
 
-# Check: every root-level SKILL.md dir must have a matching .pi/skills/<name>/SKILL.md
-for f in ./*/SKILL.md; do
-  name=$(echo "$f" | cut -d/ -f2)
+# Check: every SKILLS_ROOT SKILL.md dir must have a matching .pi/skills/<name>/SKILL.md
+for f in "$SKILLS_ROOT"/*/SKILL.md; do
+  name=$(basename "$(dirname "$f")")
   # Skip non-skill directories
   case "$name" in
     docs|node_modules|scripts|specs|dashboard|test) continue ;;
@@ -33,8 +36,8 @@ done
 
 PI_COUNT=$(ls -d .pi/skills/*/ 2>/dev/null | wc -l | tr -d ' ')
 SRC_COUNT=0
-for f in ./*/SKILL.md; do
-  name=$(echo "$f" | cut -d/ -f2)
+for f in "$SKILLS_ROOT"/*/SKILL.md; do
+  name=$(basename "$(dirname "$f")")
   case "$name" in
     docs|node_modules|scripts|specs|dashboard|test) continue ;;
   esac

package/scripts/check-skill-size.sh

@@ -6,6 +6,9 @@ set -euo pipefail
 
 REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 cd "$REPO_ROOT"
+# SKILLS_ROOT: use skills/ when it exists, fall back to repo root
+SKILLS_ROOT="$REPO_ROOT"
+[[ -d "$REPO_ROOT/skills" ]] && SKILLS_ROOT="$REPO_ROOT/skills"
 
 ERRORS=0
 
@@ -44,8 +47,8 @@ CRITICAL_PATH=(
 )
 
 # Check all */SKILL.md files
-for skill_file in */SKILL.md; do
-  skill_name="${skill_file%/SKILL.md}"
+for skill_file in "$SKILLS_ROOT"/*/SKILL.md; do
+  skill_name="$(basename "$(dirname "$skill_file")")"
   line_count=$(wc -l < "$skill_file")
 
   # Determine cap based on critical-path membership

package/scripts/generate-reference-tables.sh

@@ -7,6 +7,9 @@ set -euo pipefail
 REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 TARGET="$REPO_ROOT/docs/references/model-profiles.md"
 mkdir -p "$(dirname "$TARGET")"
+# SKILLS_ROOT: use skills/ when it exists, fall back to repo root
+SKILLS_ROOT="$REPO_ROOT"
+[[ -d "$REPO_ROOT/skills" ]] && SKILLS_ROOT="$REPO_ROOT/skills"
 
 cd "$REPO_ROOT"
 
@@ -17,7 +20,7 @@ while IFS= read -r line; do
   model_raw="${line##*model: }"
   model="${model_raw// /}"
   ROWS+=("$skill_dir $model")
-done < <(grep -r "^model:" */SKILL.md | sort)
+done < <(grep -r "^model:" "$SKILLS_ROOT"/*/SKILL.md | sort)
 
 TOTAL=${#ROWS[@]}
 
@@ -35,7 +38,7 @@ for row in "${ROWS[@]}"; do
 done
 BLOCK+="
 
-Total: **$TOTAL** skills — verify with \`ls -d \*/SKILL.md | wc -l\`
+Total: **$TOTAL** skills — verify with \`find . skills -maxdepth 2 -name SKILL.md 2>/dev/null | grep -v '.git\|.cursor\|.gemini\|.pi' | sort -u | wc -l\`
 <!-- AUTO-GENERATED-CATALOG: end -->"
 
 # --- 3. Splice block into target file ---

package/scripts/generate-skill-index.sh

@@ -7,6 +7,9 @@ set -euo pipefail
 REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 LOCKFILE="$REPO_ROOT/skills-lock.json"
 INDEX_FILE="$REPO_ROOT/SKILL-INDEX.md"
+# SKILLS_ROOT: use skills/ when it exists, fall back to repo root
+SKILLS_ROOT="$REPO_ROOT"
+[[ -d "$REPO_ROOT/skills" ]] && SKILLS_ROOT="$REPO_ROOT/skills"
 
 if [[ ! -f "$LOCKFILE" ]]; then
   echo "generate-skill-index: ERROR — skills-lock.json not found. Run regenerate-lockfile.sh first." >&2
@@ -48,7 +51,9 @@ DESC_COL_WIDTH=56
   echo "> **DO NOT EDIT** — This file is auto-generated by \`scripts/generate-skill-index.sh\`."
   echo "> Edit \`SKILL.md\` source files or \`skills-lock.json\` instead. Run \`bash scripts/sync-skills.sh\` to regenerate."
   echo ""
-  echo "**Generated:** $(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  # No generation timestamp: output must be byte-identical for the same sources
+  # (CI drift gate runs git diff --exit-code). Git history records when this
+  # file changed; a wall-clock or commit-date stamp makes every run dirty.
   echo "**Skills:** $(jq '.skills | length' "$LOCKFILE")"
   echo ""
 
@@ -157,7 +162,7 @@ DESC_COL_WIDTH=56
   echo "1. Run \`bash scripts/sync-skills.sh\` to regenerate this file and all artifacts."
   echo "2. Or run \`bash scripts/generate-skill-index.sh\` to only regenerate this index."
   echo ""
-  echo "→ verify: \`find . -maxdepth 2 -name \"SKILL.md\" | grep -v \".git\\|.cursor\\|.gemini\" | wc -l\`"
+  echo "→ verify: \`find . skills -maxdepth 2 -name \"SKILL.md\" 2>/dev/null | grep -v \".git\\|.cursor\\|.gemini\\|.pi\" | sort -u | wc -l\`"
   echo ""
 
 } > "$INDEX_FILE"

package/scripts/install.sh

@@ -14,6 +14,9 @@
 set -euo pipefail
 
 REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+# SKILLS_ROOT: use skills/ subdirectory when it exists, fall back to repo root
+SKILLS_ROOT="$REPO_ROOT"
+[[ -d "$REPO_ROOT/skills" ]] && SKILLS_ROOT="$REPO_ROOT/skills"
 
 DRY_RUN=false
 UNINSTALL=false
@@ -66,7 +69,7 @@ install_claude() {
   echo ""
   echo "Claude Code → $CLAUDE_SKILLS_DIR/"
   local count=0
-  for skill_dir in "$REPO_ROOT"/*/; do
+  for skill_dir in "$SKILLS_ROOT"/*/; do
     [[ -f "$skill_dir/SKILL.md" ]] || continue
     local name; name="$(basename "$skill_dir")"
     link "$skill_dir" "$CLAUDE_SKILLS_DIR/$name"

package/scripts/regenerate-lockfile.sh

@@ -6,11 +6,14 @@ set -euo pipefail
 
 REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 LOCKFILE="$REPO_ROOT/skills-lock.json"
+# SKILLS_ROOT: use skills/ when it exists, fall back to repo root
+SKILLS_ROOT="$REPO_ROOT"
+[[ -d "$REPO_ROOT/skills" ]] && SKILLS_ROOT="$REPO_ROOT/skills"
 
 # Build JSON using jq from individual skill records
 # We pipe each skill as a JSON object, then jq -s merges them into an object keyed by name
 records=()
-for skill_dir in "$REPO_ROOT"/*/; do
+for skill_dir in "$SKILLS_ROOT"/*/; do
   skill_md="$skill_dir/SKILL.md"
   [[ -f "$skill_md" ]] || continue
 

package/scripts/run-skill-verify.sh

@@ -18,6 +18,9 @@ fi
 
 REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 cd "$REPO_ROOT"
+# SKILLS_ROOT: use skills/ when it exists, fall back to repo root
+SKILLS_ROOT="$REPO_ROOT"
+[[ -d "$REPO_ROOT/skills" ]] && SKILLS_ROOT="$REPO_ROOT/skills"
 
 PASS=0; FAIL=0; SKIP=0
 TARGET="${1:-}"
@@ -70,7 +73,7 @@ if [ -n "$TARGET" ]; then
     exit 1
   fi
 else
-  for skill_md in */SKILL.md; do
+  for skill_md in "$SKILLS_ROOT"/*/SKILL.md; do
     run_skill "$skill_md"
   done
 fi

package/scripts/sync-skills.sh

@@ -4,6 +4,10 @@
 set -euo pipefail
 
 REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+# SKILLS_ROOT: use skills/ subdirectory when it exists, fall back to repo root
+# This allows e29s02 to git-mv skill dirs into skills/ without changing this script.
+SKILLS_ROOT="$REPO_ROOT"
+[[ -d "$REPO_ROOT/skills" ]] && SKILLS_ROOT="$REPO_ROOT/skills"
 CURSOR_RULES="$REPO_ROOT/.cursor/rules"
 GEMINI_EXT_DIR="$REPO_ROOT/.gemini/extensions/bigpowers"
 GEMINI_SKILLS="$GEMINI_EXT_DIR/skills"
@@ -27,7 +31,7 @@ rm -rf "${PI_PROMPTS:?}"/*
 
 skill_count=0
 
-for skill_dir in "$REPO_ROOT"/*/; do
+for skill_dir in "$SKILLS_ROOT"/*/; do
   skill_md="$skill_dir/SKILL.md"
   [[ -f "$skill_md" ]] || continue
 
@@ -163,7 +167,7 @@ if [[ -n "$OPN_TARGET" ]] && [[ -d "$OPN_TARGET" ]]; then
   OPN_SKILLS="$OPN_TARGET/skills"
   mkdir -p "$OPN_SKILLS"
   opencode_count=0
-  for skill_dir in "$REPO_ROOT"/*/; do
+  for skill_dir in "$SKILLS_ROOT"/*/; do
     skill_md="$skill_dir/SKILL.md"
     [[ -f "$skill_md" ]] || continue
     skill_name=$(basename "$skill_dir")
@@ -189,6 +193,28 @@ if [[ -x "$REPO_ROOT/scripts/build-skill-index.sh" ]]; then
   bash "$REPO_ROOT/scripts/build-skill-index.sh" || true
 fi
 
+# Prune orphan cursor rules — .mdc files whose skill directory no longer exists.
+# Allowlist: hand-maintained rules that intentionally have no SKILL.md source.
+CURSOR_KEEP="context7.mdc"
+for mdc in "$CURSOR_RULES"/*.mdc; do
+  [[ -e "$mdc" ]] || continue
+  mdc_base=$(basename "$mdc")
+  case " $CURSOR_KEEP " in *" $mdc_base "*) continue ;; esac
+  if [[ ! -f "$SKILLS_ROOT/${mdc_base%.mdc}/SKILL.md" ]]; then
+    rm "$mdc"
+    echo "  → pruned orphan cursor rule: $mdc_base"
+  fi
+done
+
+# Stamp the README skill-count badge from the live count — never hardcode it by hand.
+# Portable (BSD/GNU): write to temp file instead of sed -i.
+readme="$REPO_ROOT/README.md"
+if [[ -f "$readme" ]] && grep -q 'badge/skills-' "$readme"; then
+  readme_tmp=$(mktemp)
+  sed -E "s|(badge/skills-)[0-9]+(-brightgreen)|\1${skill_count}\2|" "$readme" > "$readme_tmp"
+  mv "$readme_tmp" "$readme"
+fi
+
 echo "sync-skills: $skill_count skills synced"
 echo "  → .cursor/rules/ ($skill_count .mdc files)"
 echo "  → .gemini/extensions/bigpowers/skills/ (Agent Skills)"

package/{quick-fix → skills/quick-fix}/SKILL.md

@@ -99,14 +99,6 @@ Invoke `release-branch` to merge and ship.
 
 → verify: `test -f quick-fix/SKILL.md && grep -q '^name:' quick-fix/SKILL.md && echo "OK: quick-fix valid" || echo "FAIL: quick-fix missing"`
 
-
-```bash
-test -f quick-fix/SKILL.md && echo "OK: skill file exists" || echo "FAIL: no skill file"
-grep -q "name: quick-fix" quick-fix/SKILL.md && echo "OK: frontmatter" || echo "FAIL: frontmatter"
-grep -qi "data.only\|trivial\|fast.path\|guardrail\|abort" quick-fix/SKILL.md && echo "OK: entry criteria and guardrails"
-grep -q "quick-fix" SKILL-INDEX.md && echo "OK: in SKILL-INDEX"
-```
-
 ## Example
 
 ### Bosnia flag missing from FLAGS dictionary

package/{using-bigpowers → skills/using-bigpowers}/SKILL.md

@@ -99,7 +99,7 @@ Start the HTTP dashboard with `visual-dashboard` → `GET /api/status?projectDir
 - **Integrate:** team default is `gh pr` (team-pr); solo profile uses `land-branch.sh`. Never create GitHub issues from skills — use local Markdown files instead.
 - **One skill, one thing.** If you're unsure which skill to call, call `survey-context` — it reads your current state and recommends the next step.
 - **verify: every step.** Every epic task must have `verify: <runnable command>`. Evidence over claims.
-- **70 skills.** See `SKILL-INDEX.md`; find skills with `search-skills`.
+- **The full catalog is auto-generated.** See `SKILL-INDEX.md`; find skills with `search-skills`.
 
 ## After this