What problem does it solve?
too-many-skills eliminates the operational chaos of having many agent skill directories spread across multiple locations by consolidating them into a single, consistent local root and replacing legacy paths with safe worktree-backed symlinks.
Core Features & Use Cases
- Consolidate scattered skill installs: Collects discovered skills from configured source roots and migrates them into
~/repo/agent/skills/<skill-name>/ using a flat namespace.
- Safe legacy path replacement: Replaces original locations with symlinks pointing to the consolidated target to keep paths working while ensuring reversibility.
- Collision detection & merge strategy: Detects name/content/inode/realpath identity collisions and applies deterministic dedupe/merge/branch-archive policies while writing manifests for audit and rollback.
- Inventory-driven cross-space sync (SQLite service): Maintains a SQLite inventory of which skills exist (DIR vs symlink target) across agent spaces and can apply conservative changes to keep spaces aligned.
- Rollback via manifest: Uses the generated
last-run.jsonl manifest to undo supported migrate/link actions when needed.
Quick Start
Run the consolidate action in place to scan configured roots, migrate safe skills into ~/repo/agent/skills/, and replace sources with symlinks.