bigpowers 2.43.5 → 2.44.1

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/scripts/validate-doctrine.sh

@@ -24,7 +24,7 @@ pass() {
 echo "--- [Epic 1] dead skill names in docs/references/model-profiles.md ---"
 DEAD=()
 while IFS= read -r name; do
-  if [[ ! -d "$name" ]]; then
+  if [[ ! -d "$name" && ! -d "skills/$name" ]]; then
     DEAD+=("$name")
   fi
 done < <(grep -oE '`[a-z][a-z-]+`' docs/references/model-profiles.md \
@@ -60,7 +60,11 @@ fi
 
 # ── Epic 1: Skill count consistency ───────────────────────────────────────────
 echo "--- [Epic 1] skill count consistency ---"
-LIVE_COUNT=$(ls -d */SKILL.md 2>/dev/null | wc -l | tr -d ' ')
+LIVE_COUNT=$(ls -d skills/*/SKILL.md 2>/dev/null | wc -l | tr -d ' ')
+# Fallback: count root-level skill dirs if skills/ doesn't exist (pre-e29 layout)
+if [[ "$LIVE_COUNT" -eq 0 ]]; then
+  LIVE_COUNT=$(ls -d */SKILL.md 2>/dev/null | wc -l | tr -d ' ')
+fi
 STALE_COUNT_HITS=$(grep -rE "expect [0-9]+" docs/ 2>/dev/null \
   | grep -v "expect $LIVE_COUNT" | wc -l | tr -d ' ') || true
 if [[ "$STALE_COUNT_HITS" -eq 0 ]]; then
@@ -120,7 +124,8 @@ echo "--- [Epic 5] critical-path handoff targets ---"
 CRITICAL_HANDOFF=(survey-context plan-work develop-tdd verify-work audit-code release-branch kickoff-branch commit-message)
 MISSING_HANDOFF=()
 for s in "${CRITICAL_HANDOFF[@]}"; do
-  if [[ -f "$s/SKILL.md" ]] && ! grep -qiE "handoff|next_skill|next:" "$s/SKILL.md"; then
+  if [[ ! -f "$s/SKILL.md" && ! -f "skills/$s/SKILL.md" ]]; then continue; fi
+  if ! grep -qiE "handoff|next_skill|next:" "${s}/SKILL.md" "skills/${s}/SKILL.md" 2>/dev/null; then
     MISSING_HANDOFF+=("$s")
   fi
 done

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