Rebuild Skill Index

Rebuild Skill Index

Generate one index file per platform, specific to the current Claude Code config. Each file is the extended list of every platform-relevant skill installed on this machine that is not already in the curated list inside the matching agent's markdown file.

Outputs are consumed by the matching subagents (ios-dev, android-dev, designer, marketer, neo4j-dev) and any caller that dispatches them (/specialist-review, /plan-review, /todos-review).

Step 0: Resolve base directory

Either harness may be invoked with a non-default config home — CLAUDE_CONFIG_DIR on Claude Code, CODEX_HOME on Codex. Resolve the running session's base directory first via Bash:

# Codex exports CODEX_THREAD_ID on every session, while CODEX_HOME exists only
# when the user sets one; anything that is not Codex keeps the Claude path.
if [ -n "${CODEX_THREAD_ID:-}" ]; then
  BASE="${CODEX_HOME:-$HOME/.codex}"
else
  BASE="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
fi
echo "$BASE"

Use the resolved absolute value in all subsequent read and write paths and in Path: metadata written into output files — readers should not have to re-resolve.

Step 1: Collect candidate skills

For each source below, read frontmatter only (the name: and description: fields). Do not read full SKILL.md bodies — that would burn unnecessary tokens. Use Read file_path=<path> limit=30 (30 lines covers any reasonable frontmatter).

Shared sources (used by every platform's classifier):

1. User-level skills: Glob pattern: $BASE/skills/*/SKILL.md

Android-specific sources:

• None beyond the shared user-level glob. All curated Android skills are vendored inside android-dev itself (under <plugin>/skills/) and excluded via the dedup list in Step 2.

iOS-specific sources:

2. Axiom plugin skills (optional):

   ls "$BASE/plugins/cache/axiom-marketplace/axiom/" | sort -V | tail -1

   • If the directory exists, use the highest semver version returned above and glob: $BASE/plugins/cache/axiom-marketplace/axiom/<version>/skills/*/SKILL.md
   • If it does not exist, record a "missing" warning for the iOS output file.

Design-specific sources:

3. frontend-design plugin (optional):

   ls -t "$BASE/plugins/cache/claude-plugins-official/frontend-design/" | head -1

   • This plugin uses hash directories, not semver; ls -t | head -1 picks the newest by mtime — matches "the one currently installed" even when multiple hash dirs coexist.
   • If present: $BASE/plugins/cache/claude-plugins-official/frontend-design/<hash>/skills/*/SKILL.md
   • If absent, record a "missing" warning for the design output file.

4. ui-ux-pro-max-skill plugin (optional):

   ls "$BASE/plugins/cache/ui-ux-pro-max-skill/ui-ux-pro-max/" | sort -V | tail -1

   • If present: $BASE/plugins/cache/ui-ux-pro-max-skill/ui-ux-pro-max/<version>/skills/*/SKILL.md
   • If absent, record a "missing" warning for the design output file.

Marketer-specific sources:

5. frontend-slides plugin (optional):

   ls "$BASE/plugins/cache/frontend-slides/frontend-slides/" | sort -V | tail -1

   • Slide-oriented skills — included in the marketer index because presentations are a content/brand output (the slide-design curated skill orchestrates them).
   • If present: $BASE/plugins/cache/frontend-slides/frontend-slides/<version>/skills/*/SKILL.md
   • If absent, skip silently (no warning — this is bonus, not required).

6. revealjs plugin (optional):

   ls "$BASE/plugins/cache/revealjs/revealjs/" | sort -V | tail -1

   • Same rationale as frontend-slides — alternative slide engine used by slide-design.
   • If present: $BASE/plugins/cache/revealjs/revealjs/<version>/skills/*/SKILL.md
   • If absent, skip silently.

Neo4j-specific sources:

• None beyond the shared user-level glob. All curated Neo4j skills are vendored inside neo4j-dev itself.

Step 2: Read curated dedup lists

Read each agent's markdown from the solopreneur marketplace plugins. Find the ## Curated Skills section. Extract skill names from every bullet line that looks like:

- `<skill-name>` — <description>

The section is subdivided by source (Plugin-bundled / Third-party / …). Collect names from all subsections — they form the per-agent dedup blacklist and should not be re-included in that agent's extended index. Names may be bare (asc-release-flow) or namespaced (ios-dev:ios-patterns, axiom:axiom-ios-ui) — strip any <plugin>: prefix before comparing against candidate skill names.

Agents to read (each lives in its own sub-plugin):

• ios-dev.md (from ios-dev) → iOS dedup list
• android-dev.md (from android-dev) → Android dedup list
• designer.md (from designer) → design dedup list
• marketer.md (from marketer) → marketer dedup list
• neo4j-dev.md (from neo4j-dev) → neo4j-dev dedup list

Locate each agent file via Glob (widens across any marketplace name the user chose at claude plugin marketplace add --name):

Glob: $BASE/plugins/cache/*/<plugin>/*/agents/<name>.md

If multiple versions coexist, take the highest semver match.

If you can't find an agent file, ask the user where that sub-plugin is installed and continue with an empty dedup list for that platform (the extended file will have duplicates with curated, which is fine — costs one extra entry per dup).

Step 3: Classify each candidate

For each skill not in a given platform's dedup list, judge from name + description whether it is relevant to that platform. Each candidate can be classified into multiple platforms (e.g., a SwiftUI-specific design skill belongs in both ios.md and design.md).

Be inclusive but not sloppy.

iOS classification

• Yes: Swift / SwiftUI / UIKit / Xcode / iOS / macOS / iPadOS / watchOS / tvOS / visionOS / Apple frameworks (CoreData, AVFoundation, CoreLocation, etc.) / Apple toolchain (lldb, Instruments, asc CLI, App Store Connect)
• No: web (React, Vue, Next.js, CSS), Android (Kotlin, Compose, Room), Python, LLM/agent frameworks, generic design tools, infra/devops, prose helpers
• Borderline (e.g. cross-platform performance audit, generic git workflow): exclude. Curated catches must-haves; extended is best-effort.

Android classification

• Yes: Kotlin / Jetpack Compose / Android Gradle / Hilt / Room / Retrofit / Coroutines / Flow / WorkManager / KMP-on-Android / Material Design (Material 3, Material You) / AGP / R8 / ProGuard / Android Studio / adb / gradlew / Google Play Console (gplay-*, signing, release flows, in-app purchases) / Android-specific testing (Roborazzi, Espresso, Compose UI testing)
• No: web (React, Vue, Next.js, CSS), iOS (Swift, SwiftUI, Xcode, asc CLI), Python, LLM/agent frameworks, generic design tools, infra/devops, prose helpers
• Borderline (e.g. cross-platform performance audit, generic git workflow): exclude. Curated catches must-haves; extended is best-effort.