[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83385":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":16,"stars90d":14,"forks30d":14,"starsTrendScore":17,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":9,"trendingCount":14,"starSnapshotCount":14,"syncStatus":26,"lastSyncTime":27,"discoverSource":28},83385,"Skill-Routing-Kit","juew\u002FSkill-Routing-Kit","juew","Skill Routing Kit 是一个本地优先的 Codex 插件，用来提升 skill 和插件的命中率，同时避免引入缓慢、强侵入的运行时路由层。",null,"Python",111,4,1,0,12,41,48,85.91,"MIT License",false,"main",true,[],"2026-06-12 04:01:41","\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Flogo.png\" alt=\"Skill Routing Kit logo\" width=\"160\" \u002F>\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">Skill Routing Kit\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  Make Codex pick the right skill or plugin more often.\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"README.zh-CN.md\">中文说明\u003C\u002Fa>\n  ·\n  \u003Ca href=\"README.en.md\">Full English docs\u003C\u002Fa>\n  ·\n  \u003Ca href=\"docs\u002Fdemo.md\">Demo\u003C\u002Fa>\n  ·\n  \u003Ca href=\"docs\u002Frelease-v0.1.0.md\">Release notes\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg alt=\"Codex plugin\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCodex-plugin-22D3EE\">\n  \u003Cimg alt=\"Local first\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flocal--first-no%20network%20by%20default-10B981\">\n  \u003Cimg alt=\"CI\" src=\"https:\u002F\u002Fgithub.com\u002Fjuew\u002FSkill-Routing-Kit\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg\">\n  \u003Cimg alt=\"License\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-111827\">\n\u003C\u002Fp>\n\n## Why This Exists\n\nCodex can have dozens of skills and plugins installed, but the correct one does not always trigger.\n\nThat creates a quiet productivity tax:\n\n- a PDF input gets mistaken for the final artifact;\n- a routing\u002Fdebugging question gets handled by the wrong domain skill;\n- connector plugins are considered even when the user's work is local;\n- new skills are installed, but nobody remembers when to use them.\n\nSkill Routing Kit adds a small local-first routing layer for Codex. It helps Codex answer:\n\n```text\nWhat kind of task is this?\nWhere is the source of truth?\nWhat is the final artifact?\nWhich skill should be primary?\nWhich plugin is only a helper?\nWhen should a tempting skill not be used?\n```\n\n## What You Get\n\n- `skill-router`: a Codex skill for diagnosing skill\u002Fplugin routing decisions.\n- Local registry: a JSON capability index with categories, use cases, negative examples, and provenance.\n- Routing guard: an `AGENTS.md` snippet that makes routing a quiet default behavior.\n- Diagnostic scripts: route a request, refresh the registry, and check stale or broken entries.\n- Local-first safety: no background scan, no telemetry, no connector content reads, no network by default.\n\n## 30-Second Install\n\nIf you use Codex, ask it to install the plugin for you:\n\n```text\nPlease install the Skill Routing Kit plugin from https:\u002F\u002Fgithub.com\u002Fjuew\u002FSkill-Routing-Kit. Install the plugin source globally at ~\u002Fplugins\u002Fskill-routing-kit, register it in ~\u002F.agents\u002Fplugins\u002Fmarketplace.json, run codex plugin add skill-routing-kit@personal, and enable the routing guard globally in ~\u002F.codex\u002FAGENTS.md. Do not install it into the current project. Do not ask me to create directories manually; use the repository installer and verify the plugin after installation.\n```\n\nOr run one command:\n\n```bash\n\u002Fbin\u002Fbash -c \"$(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fjuew\u002FSkill-Routing-Kit\u002Fmain\u002Fscripts\u002Finstall.sh)\" -- --install-agents --codex-add\n```\n\nThe installer creates directories, updates your personal Codex marketplace, enables the plugin, and backs up older local copies.\n\n## Before And After\n\n### Routing Diagnostic\n\n```bash\npython3 scripts\u002Froute_request.py \"为什么 pdf skill 没有命中这个请求\"\n```\n\nExpected result:\n\n```text\nRecommended skill\u002Fplugin:\n- Skill Router (skill-router)\n\nHelper skills\u002Fplugins:\n- PDF (pdf)\n\nWhy:\n- routing diagnostic request prefers the skill-router capability\n- local-first preference\n```\n\n### Final Artifact Routing\n\n```bash\npython3 scripts\u002Froute_request.py \"把这个 PDF 整理成一份 PPT\"\n```\n\nExpected result:\n\n```text\nRecommended skill\u002Fplugin:\n- Presentations (presentations)\n\nHelper skills\u002Fplugins:\n- PDF (pdf)\n```\n\nThe final artifact is the presentation. The PDF skill is useful context, not the primary route.\n\nMore examples: [docs\u002Fdemo.md](docs\u002Fdemo.md)\n\n## How It Works\n\nSkill Routing Kit turns skill\u002Fplugin selection into a lightweight recall-and-rerank loop.\n\n```mermaid\nflowchart LR\n  A[\"User request\"] --> B[\"Routing guard\"]\n  B --> C[\"Classify task, source, artifact, process\"]\n  C --> D[\"Recall candidates from registry\"]\n  D --> E[\"Rerank by final artifact, source, action, risk\"]\n  E --> F[\"Use primary skill\u002Fplugin\"]\n  E --> G[\"Keep helper skills contextual\"]\n```\n\nThe methodology is simple:\n\n- describe **when to use** each capability;\n- classify capabilities into layered routing categories such as `process`, `source`, `artifact`, `domain`, and `risk`;\n- describe **when not to use** each capability with negative examples;\n- recall broad candidates first, then rerank by final artifact, source, task action, and permission risk.\n\n## Safety Model\n\nThis project is intentionally conservative.\n\n- It reads local `SKILL.md`, `plugin.json`, and registry metadata.\n- It does not read Gmail, Slack, Notion, Drive, or other connector content.\n- It does not check connector authorization.\n- It does not install hooks, telemetry, daemons, or background scanners.\n- It can be removed by deleting the `AGENTS.md` block and uninstalling the plugin.\n\n## Common Commands\n\n```bash\n# Validate the plugin\npython3 \u002FUsers\u002Fzhonghao\u002F.codex\u002Fskills\u002F.system\u002Fplugin-creator\u002Fscripts\u002Fvalidate_plugin.py .\n\n# Run tests\npython3 -B -m unittest discover -s tests\n\n# Route one request\npython3 scripts\u002Froute_request.py \"帮我把这个 PDF 做成 PPT 并保留版式\"\n\n# Check registry health\npython3 scripts\u002Froute_request.py --check-registry\n\n# Refresh generated registry\npython3 scripts\u002Fbuild_registry.py --yes\n```\n\n## Who Should Star This\n\nStar this repo if you are:\n\n- building Codex skills or plugins;\n- using many AI agent capabilities and seeing missed triggers;\n- designing local-first agent workflows;\n- maintaining a team skill library;\n- interested in explainable routing for AI tools.\n\n## Roadmap\n\n- Registry diff after skill\u002Fplugin install or removal.\n- Better negative-example authoring tools.\n- Optional embedding-based reranker.\n- Route quality evaluation suite.\n- UI screenshots and short demo GIF.\n- More connector-aware but still local-first policy cards.\n\n## Documentation\n\n- [Chinese README](README.zh-CN.md)\n- [Full English documentation](README.en.md)\n- [Demo scenarios](docs\u002Fdemo.md)\n- [Release notes](docs\u002Frelease-v0.1.0.md)\n- [Promotion kit](docs\u002Fpromotion-kit.md)\n- [Contributing guide](CONTRIBUTING.md)\n- [Changelog](CHANGELOG.md)\n\n## License\n\nMIT\n",2,"2026-06-11 04:11:03","CREATED_QUERY"]