该技能面向 Agent Skills 的检索、评估与治理:Agent Skills 是含 SKILL.md 前置元数据(name、description)及说明文件的文件夹,可附带 scripts/、references/、assets/ 等资源,按渐进式披露加载(先元数据、激活时读完整 SKILL.md、按需读捆绑资源)。
用途:当用户要求查找、比较、预览、安装、评分、评审、改进、重构或合成 Agent Skills 时使用。默认流程为 UNDERSTAND → DISCOVER → INSPECT → JUDGE → RECOMMEND → USER GATE → ACT → VERIFY;用户已给出具体来源(owner/repo 路径或本地路径)时可压缩步骤,发现结果薄弱或冲突时重复检索。
主要能力:按任务匹配度、工作流质量、安全关卡和可移植性推荐并解释取舍;每个远程候选须标注 (owner/repo, SKILL.md 路径),本地候选标注路径;推荐前检查真实 SKILL.md 内容,对高风险或不明确的候选检查影响行为的引用文件;跳过缺少有效 name 与 description 前置元数据的候选;对安装、写文件、创建本地技能、目标选择、配置变更、覆盖和符号链接决策设关卡。禁止把原始搜索列表丢给用户自行排序,禁止在许可与用户未明确允许时整体复制他人技能。
检索方式:公开技能查询需并行扇出三个渠道——Octocode/GitHub 代码与路径搜索、skills.sh 注册表 API、运行时 Web 搜索,再按 (owner/repo, 技能名) 去重。skills.sh API 调用:curl 'https://www.skills.sh/api/search?q={{SEARCH_KEY}}&limit=100' --compressed -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:150.0) Gecko/20100101 Firefox/150.0',返回含 id、skillId、name、installs、source。流行度工作流:按 installs 降序,取前 5 作为优先检查对象,经 Octocode 的 githubGetFileContent 获取其 SKILL.md(可试 skills/<skillId>/SKILL.md、<skillId>/SKILL.md、.claude/skills/<skillId>/SKILL.md),结果卡片须含安装数,但不得仅凭安装数推荐,安装数仅作平局判定。API 不可用或限流时回退到 leaderboard 页与 GitHub 主题搜索,并降低置信度。组织私有范围只用 Octocode 工具。
自改进模式:当用户要求评分、评审、改进或重构 SKILL.md 时启用,先读 references/agent-skills-guide.md,并在请求含糊时先让用户选择模式(仅评分/改进重构/采纳既往评分修复/取消)。流程为 READ → MAP INTENT → RATE ISSUES → [REWRITE → VALIDATE] → REPORT。仅评分模式不编辑文件,报告含总体分、分维度高低、按严重度分组的问题(标注 file:line)、验证清单、优点、残余风险与以“取消”结尾的编号下一步。改进模式重写后校验前置元数据、工作流步骤与关卡、引用文件存在性、MUST/NEVER/FORBIDDEN 规则,且任何写入或安装不得绕过用户关卡。
限制:工具路由依赖 Octocode MCP 及其活动描述符;运行时不具备时需把 search/read/list/download 映射到等价工具,GitHub 研究不可用时应停下询问是否使用公开网络回退。其他事实暂未提供。