skill-router

Ranks installed Codex skills by relevance to a task without loading the full catalog.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/RavitejaKarra24/dotfiles --skill skill-router-ravitejakarra24
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-router
Source: https://github.com/RavitejaKarra24/dotfiles/tree/main/codex/.codex/skills/skill-router
Command: npx skills add https://github.com/RavitejaKarra24/dotfiles --skill skill-router-ravitejakarra24

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? When many skills are installed, injecting every skill's metadata into each conversation wastes context and dilutes relevance. This Skill selects only the most relevant installed skills for a given task on demand, keeping threads lean while preserving access to specialist capabilities. ## Core Features & Use Cases - On-Demand Skill Selection: Runs a Python selector that searches project .agents/skills directories, ~/.codex/skills, ~/.agents/skills, and plugin caches, then ranks matches by frontmatter name and description. - Context-Efficient Routing: Reads only the top 1-3 matching SKILL.md files instead of the full catalog, with --limit and --all flags for control. - Use Case: Given a task like "review this Terraform module for security issues", run the selector to surface the most relevant security or infrastructure skills, then load only those instructions into context. ## Quick Start Ask the agent to route your task by running the skill-router selector with your request and project stack, then follow the top matched skill's instructions.

Frequently Asked Questions about skill-router

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the right skill for a task without loading all skills?

Run the select_skills.py script with your task description and working directory. It searches project and user skill directories, ranks frontmatter names and descriptions, and returns the top matches so you load only the relevant SKILL.md files.

How does skill routing work in Codex with skills.include_instructions disabled?

With include_instructions set to false, installed skills stay enabled but their metadata is not added to every thread. The router script queries the catalog on demand and returns ranked matches, keeping context usage minimal.

What directories does the skill selector search?

It searches project .agents/skills directories from the working directory up to the repository root, plus ~/.codex/skills, ~/.agents/skills, and installed plugin skill caches. Symlinked skills are deduplicated by resolved path.

Can I list all installed skills instead of ranked matches?

Yes, pass the --all flag to the selector to list every discovered skill sorted by name. Use --limit N to adjust how many ranked matches are returned for a normal query.

What should I do when no skill matches my task?

If the selector returns no relevant matches, proceed with the task without a skill. For multi-domain tasks, run focused subqueries per domain rather than loading the entire catalog.