skill-advisor

_{An FX Studio AI plugin for Claude Code}

What's new in v0.5.0 (2026-04-27)

Architectural overhaul closing a 10-finding audit. Quality bar lifted from 7.5 → 9+/10 with zero functional regression.

• Hot-path hook 387 → 85 lines. Scoring/fusion/discovery/replay logic extracted into the pure module lib/advisor-nudge-core.js. Hook is now a true I/O shim. Determinism is provable: same opts + fixed now() → deeply equal SuggestionResult.
• 4 architectural guards CI-enforced on every push and PR: DI-1 (constants module load is fs-pure), DI-2 (no domain code imports from builders), DI-3 (package.json and .claude-plugin/plugin.json agree on SemVer), vault env single source (paths.js no longer reads env directly).
• Module-scoped mtime + size keyed cache (lib/mtime-cache.js) memoizes embeddings/graph loaders for long-lived consumers; defeats stale-cache class on coarse filesystems (FAT32, sub-ms CI rebuilds).
• Unified filesystem walker (lib/walk.js) replaces two private walkers in build-index/build-catalog. Side effect: index now visible at 546 entries (up from 163) — the legacy walker was silently dropping skills past its visit-count cap.
• Vault env single source. SKILL_ADVISOR_VAULT_PATH is now canonical; legacy SKILL_ADVISOR_VAULT works with a one-time deprecation warning, removal in 0.6.0.
• Performance gate (npm run test:perf) — ceiling p95 ≤ 250ms + headroom 1.15× baseline, 300 spawns × 2 fixtures, ~60s. Default npm test stays at ~2.3s for fast TDD iteration.
• 812 tests (+24% from 654). Full perf gate green: short80 p95 ≈ 170ms, long500 p95 ≈ 157ms.

BREAKING (restorable). Default prompt-length threshold raised 5 → 12. Prompts of 5–11 characters that previously surfaced advisor nudges now silently early-exit. Restore the old behavior with ADVISOR_PROMPT_LENGTH=5 in your shell env.

Deprecations (both targeting 0.6.0 removal): SKILL_ADVISOR_VAULT env var (use SKILL_ADVISOR_VAULT_PATH); build-index.inferCategory re-export (use lib/category.inferCategory).

See CHANGELOG.md for full migration notes.

TL;DR · Features · Obsidian · How it works · Quickstart · Commands · Changelog

You have 200+ skills installed. You use 10. Skill Advisor finds the other 190 — and knows which ones not to mix.