skillmesh

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.