skill-router

Local semantic skill router for gemini-cli-pro.

Install

npm install -g .

The package runs this postinstall hook:

node scripts/postinstall.js

It creates an isolated venv in ~/.cache/skill-router/venv and installs:

• fastembed
• numpy

This avoids PEP 668 / externally-managed-environment failures on Ubuntu.

Usage

skill-router --prompt "rename API layer" --skills-dir /path/to/.skills

Output is always JSON:

{"skill_id":"node-backend","score":0.8732}

If score is below threshold:

{"skill_id":null,"score":0.0}

If the provided --skills-dir does not exist or has no .md files, it returns:

{"skill_id":null,"score":0.0}

Lookup order:

1. --skills-dir (default: ~/.cache/skills-router)
2. Fallback: ~/.cache/gemini-skills

Cache

Cache is stored in:

• ~/.cache/skill-router/data.npy
• ~/.cache/skill-router/.skills_cache.npy

Works on Ubuntu/Linux and macOS.