Skill RAG Router

Intelligent skill discovery and routing system using semantic search and knowledge graph relationships.

Capabilities

1. Semantic Skill Search: Uses ck --sem for meaning-based skill matching
2. Hybrid Search: Combines semantic + keyword matching via ck --hybrid
3. Session Awareness: Integrates with beads/bd for session context
4. Memory Integration: Uses claude-mem for cross-session learning

Trigger Conditions

Activate this skill when:

• User explicitly requests skill discovery (/meta, "find a skill for...")
• Task complexity score >= 0.7
• Task involves > 20 files
• Task spans > 2 domains (frontend, backend, security, etc.)
• User asks "what skill can help with..."

Usage

# Explicit invocation
/meta [query]

# Examples
/meta "optimize prompts for RAG pipeline"
/meta "debug authentication flow"
/meta "refactor legacy codebase"

Search Implementation

# Semantic search for skills
ck --sem "[query]" ~/.claude/skills/ --jsonl --top-k 5

# Hybrid search (semantic + keyword)
ck --hybrid "[query]" ~/.claude/skills/ --threshold 0.6

# Index skills
ck --index ~/.claude/skills/ --model bge-small --quiet

Output Format

Returns ranked skill suggestions with:

• Skill name and path
• Confidence score (0-1)
• Relevant snippet from SKILL.md
• Trigger match explanation

Integration Points

• SessionStart: Indexes skills, loads routing cache
• UserPromptSubmit: Analyzes prompts for skill suggestions
• beads/bd: Session-aware task tracking
• claude-mem: Cross-session routing patterns

Scripts

• scripts/index-skills.sh: Index all skills with ck
• scripts/router.sh: Main routing logic
• scripts/suggest-skills.sh: Intent → skill matching for hooks