skill-router-dynamic:用 SKILL.md 把用户意图路由到已安装 Skill

前言

在 Cursor、Claude Code、Codex 等环境里,Skill 往往越装越多:每个 Skill 有自己的触发条件和说明,Agent 要么靠固定规则挑 Skill,要么让用户自己点名。装得多了之后,「该用哪一个」会变成隐性成本,普通对话和「需要走 Skill」的请求也容易混在一起。

下面介绍 community 发布者 user_e8fae1af 在 SkillHub 上的 skill-router-dynamic(坐标 @user_e8fae1af/skill-router-dynamic,版本 0.1.0,分类 ai-agent)。它是一个纯 SKILL.md 实现的路由器:不写 Python、不依赖 pip,把一份 Skill 放进各平台约定的 skills 目录即可;通过 ENTRY GUARD → SCAN → MATCH → LOAD GUARD → VERIFY HOOK → CONTROL HOOK 的生命周期,把用户意图对齐到当前已安装、且匹配度最高的 Skill。官方说明审计日志会带 [skill-router] 前缀,便于在会话里区分路由行为。

这是什么

skill-router-dynamic 的定位是:在支持 SKILL.md 的 Agent 平台上,自动发现已安装 Skill,并根据用户意图选择最合适的一个再加载执行。

维护方是 SkillHub 社区用户 user_e8fae1af(来源标注为 community)。标签 requires_api_key=false,表示按页面说明不需要额外 API Key。SkillHub 页面当前显示评分 100000、下载 710(统计以页面为准,会变动)。

它要解决的问题可以概括成两点:跨平台统一「扫本地 Skill + 匹配意图」;在加载前、执行后各加一道闸门,并支持会话内的后续路由(CONTROL HOOK)。

核心功能

以下能力均来自官方简介与 SkillHub 页面,按生命周期说明。

跨平台 SKILL.md 路由

官方写明可在 Claude Code、WorkBuddy、OpenCode、Gemini CLI、Codex、OpenClaw、Cursor 以及任何使用 SKILL.md 的平台上工作。实现方式是路由器本身也是一份 SKILL.md,而不是独立守护进程。

六段生命周期

  1. ENTRY GUARD:判断用户是要「走路由选 Skill」,还是普通闲聊,避免误触发。
  2. SCAN:在 8 个平台约定路径下发现当前已安装的全部 Skill(与「跨平台」表述一致)。
  3. MATCH:把用户意图与各 Skill 的 triggers 和 description 做比对,选出最佳匹配。
  4. LOAD GUARD:在真正加载目标 Skill 前做置信度门槛,降低错配。
  5. VERIFY HOOK:目标 Skill 执行结束后检查结果是否合理。
  6. CONTROL HOOK:在同一会话中保持状态,便于后续追问时继续路由。

零运行时依赖

官方强调:No Python, no pip install, no dependencies。部署模型是 Just drop SKILL.md into your skills directory——把该 Skill 的 SKILL.md 放到当前 Agent 使用的 skills 目录即可。

安装与启用

SkillHub 提供的安装方式是让 AI 按 SkillHub 安装说明拉取指定坐标,而不是在本机 git clone。

在 SkillHub 技能页「将提示词发送给你的 AI 安装该 skills」中,官方给出的提示等价于:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_e8fae1af/skill-router-dynamic`。

经过上面的步骤,安装结果应是版本 0.1.0 的 @user_e8fae1af/skill-router-dynamic。各平台 skills 目录路径以对应产品与 skillhub.md 为准;本文未在官方资料中核对到 Cursor / Codex / Claude Code 的逐条路径差异,因此不单独罗列。

启用后,该 Skill 作为路由器参与对话;需要排查时可在日志或输出中查找 [skill-router] 前缀。

典型用法

官方资料未附带可复制粘贴的端到端对话脚本,可复现的用法可以归纳为下面两类。

安装路由器本身:按上一节让 Agent 读取 https://skillhub.cn/install/skillhub.md 并安装 @user_e8fae1af/skill-router-dynamic。

日常使用:在已安装多个 Skill 的环境里,用自然语言描述任务(与各 Skill 的 triggers、description 相关的内容)。路由器会先走 ENTRY GUARD,再 SCAN 本地 Skill 列表,MATCH 后仅在通过 LOAD GUARD 时加载目标 Skill;执行完由 VERIFY HOOK 校验,同会话后续由 CONTROL HOOK 接续。

具体触发词与阈值写在该 Skill 自带的 SKILL.md 中,应以安装后的文件为准。

适用场景与注意

适合谁

  • 在同一台机器或同一工作流里混用多种 Agent 产品,且都希望用 SKILL.md 管理 Skill 的团队或个人。
  • 已安装较多 Skill,希望由 Agent 根据意图自动选型,而不是每次手动指定 Skill 名的场景。

限制与注意

  • 路由质量依赖各 Skill 的 triggers 与 description 是否清晰;描述含糊时,MATCH 与 LOAD GUARD 可能选不中或拒绝加载。
  • 纯 SKILL.md 方案意味着行为边界由 Skill 文档定义,升级版本(当前 0.1.0)后应重新确认 SKILL.md 是否有变更。
  • SkillHub 页面显示 安装 0 与 下载 710 并存,只说明页面统计口径,不代表本地是否已启用;是否生效以你当前 Agent 的 skills 目录为准。
  • 本文不写未在官方页面出现的配置字段、CLI 子命令或性能数据。

结尾

skill-router-dynamic 把「发现已安装 Skill → 匹配意图 → 带闸门地加载与校验」收进一份可跨平台投放的 SKILL.md,适合作为多 Skill 环境下的统一入口。详情与安装提示以 SkillHub 为准:

  • API / 资源页:https://api.skillhub.cn/user_e8fae1af/skill-router-dynamic
  • 技能页:https://www.skillhub.cn/skills/user_e8fae1af/skill-router-dynamic
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye