juew/skill-routing-kit

Skill Routing Kit is a plugin for Codex, an AI coding assistant that can have many skills and plugins installed at once. The problem it addresses is that when Codex has many capabilities available, it does not always pick the right one for a given task. A question about routing or debugging might land in the wrong domain skill, a PDF file might be mistaken for a final output instead of source material, a newly installed skill may never get used because nothing prompts Codex to consider it. The kit adds a lightweight local routing layer to help Codex answer questions like: what kind of task is this, what is the expected output, and which skill should handle it versus which one should only assist. It works by maintaining a local JSON registry of installed capabilities, each tagged with descriptions of when to use it, what category it belongs to (source, process, artifact, domain, or risk), and negative examples of when not to use it. When a request comes in, a routing guard fires first, classifies the task, recalls candidates from the registry, then reranks them by which skill best matches the final output the user actually wants. The result is that the primary skill is used for the main work while other relevant skills are kept in a supporting role rather than potentially overriding each other. The kit is local-first: it reads local skill metadata files and plugin configs, does not connect to the internet by default, does not read external services like email or cloud storage, and does not install background processes or telemetry. It can be uninstalled by removing a block from a config file and running a plugin remove command. Installation can be done by asking Codex directly with a plain-English instruction, or by running a shell install script. Python diagnostic scripts are included for checking routing decisions, validating the registry, and rebuilding the capability index after adding or removing skills. The project is written in Python and licensed under MIT.