| name | skill-retrieval |
| description | Semantic search over skill libraries using ColBERT embeddings. Use when:
- "find a skill for..." or "search for skills that..."
- "what skill handles..." or "which skill can..."
- "index my skills" or "rebuild the skill index"
- "show me relevant skills for this task"
|
| allowed-tools | ["Read","Grep","Glob","Bash"] |
Skill Retrieval System
ColBERT-based semantic search over skill libraries.
Quick Start
voyager skill index --verbose
voyager skill find "resume where we left off"
voyager skill find "what should I work on next"
voyager skill find "turn this workflow into a skill"
CLIs
voyager skill index
Build or update the skill search index.
voyager skill index [OPTIONS]
Options:
--paths PATH — Additional skill directories to index
--output DIR — Index location (default: ~/.skill-index/)
--rebuild — Force rebuild from scratch
--skip-llm — Skip LLM analysis (faster but lower quality)
-v, --verbose — Show progress
voyager skill find
Search for relevant skills.
voyager skill find "your query" [OPTIONS]
Options:
-k, --top-k N — Number of results (default: 5)
--index DIR — Index location
--json — Output as JSON
Index Locations
- Default:
~/.skill-index/
- Override via
VOYAGER_SKILL_INDEX_PATH env var
- Local dogfooding:
--output ./.claude/voyager/skill-index/
Skill Sources
Auto-discovers skills from:
- Plugin skills:
./skills/
- Local mirror:
./.claude/skills/local/
- Generated skills:
./.claude/skills/generated/
- User skills:
~/.claude/skills/
Override with CLAUDE_SKILLS_PATH env var.
How It Works
- Discovery: Find all
SKILL.md files in known locations
- Analysis: Use LLM to extract metadata (purpose, triggers, capabilities)
- Embedding: Generate searchable text from metadata
- Indexing: Build ColBERT index for fast semantic search
Indexing happens once; search is instant (no LLM calls).
See reference.md for implementation details.