| name | skillmesh |
| description | Retrieve the most relevant SkillMesh cards from a registry and inject a Codex-ready context block before coding. Use when a task spans many domains and you want top-K routing instead of loading the full skill catalog. |
How to use
- Ask:
Route this request with SkillMesh: <your task>
- Run the router script to emit routed context.
- Continue the task using only the returned top-K cards.
Command
Use scripts/route.sh (or scripts/route.py) to emit context:
scripts/route.sh --provider codex --registry <path> --query "<query>" --top-k 5
Role Commands
List available roles and install a role bundle (role card + missing dependency cards):
skillmesh roles
skillmesh roles list
skillmesh Data-Analyst install
skillmesh roles install Data-Analyst
Use --dry-run to preview install changes.
If skillmesh is not on PATH, use:
scripts/roles.sh (interactive)
Parameters
--registry: Registry file path (tools.yaml, tools.json, or roles.registry.yaml).--provider: codex (default) or claude.--top-k: Number of cards to retrieve (default 5).--backend: auto, memory, or chroma (default auto).--dense: Enable optional dense reranking.--instruction-chars: Max instruction chars per expert (default 700).--query: User request text.
Notes
- If
--registry is omitted, the router uses SKILLMESH_REGISTRY.
- If
skillmesh is not on PATH, the router falls back to python -m skill_registry_rag.
