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.
install
source · Clone the upstream repo
git clone https://github.com/varunreddy/SkillMesh
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/varunreddy/SkillMesh "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/skillmesh" ~/.claude/skills/varunreddy-skillmesh-skillmesh && rm -rf "$T"
manifest:
skills/skillmesh/SKILL.mdsource content
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 file path (--registry
,tools.yaml
, ortools.json
).roles.registry.yaml
:--provider
(default) orcodex
.claude
: Number of cards to retrieve (default--top-k
).5
:--backend
,auto
, ormemory
(defaultchroma
).auto
: Enable optional dense reranking.--dense
: Max instruction chars per expert (default--instruction-chars
).700
: User request text.--query
Notes
- If
is omitted, the router uses--registry
.SKILLMESH_REGISTRY - If
is not onskillmesh
, the router falls back toPATH
.python -m skill_registry_rag