关于 skill-search
skill-search 是一个 Agent 技能,用于搜索已安装的技能目录,包括宿主常规列表中隐藏的技能。它引导 Agent 重述任务、生成搜索概念,并打开和遵循匹配的 SKILL.md。
主要功能
- 01搜索完整的已安装技能目录
- 02将隐藏技能纳入结果
- 03生成概念及其同义词
- 04检查匹配技能的 SKILL.md
- 05无法运行时改为本地描述搜索
适用场景
- 01为任务查找合适的技能
- 02确认某项需求是否有对应技能
- 03查找宿主列表中未显示的技能
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ ssheleg/ make-skill --skill skill-search安装后在 Claude Code 中输入/skill-search确认已加载。
详细介绍
skill-search — 每项任务的第一步
大多数已安装的技能都会刻意从宿主的技能列表中隐藏:Claude Code 会在有限的预算内列出描述,操作人员会将大多数技能标记为 user-invocable-only;Codex 会将它们标记为 enabled = false。因此,列表并不是目录。请搜索目录。用户也可能会问“有没有适用的技能”/«есть ли скилл»:用一行话重述请求,将其转化为包含同义词的概念,然后搜索并遵循匹配的 SKILL.md。
步骤
-
用一行话重述请求——用你自己的话说明操作人员想完成什么。这一行概括的是你要搜索的含义,而不是原话。
-
判断技能是否有帮助。 对于问题、解释或单行编辑,无需技能——说明这一点并继续。其他情况则继续。
-
将含义转化为概念:用英语和俄语写出 3–8 个简短术语,并加入同义词和涉及的产物(
pdf, документ, extract text, извлечь текст)。说出领域,而不只是动词。 -
搜索整个目录:
npx --yes sshlg-skills toolkit --find "<concept>, <concept>, …"它会打印每个匹配项的 id、得分、匹配的概念、可见性(已列出或隐藏)以及 SKILL.md 路径。隐藏的匹配项与已列出的匹配项同等对待。
-
打开合适条目的 SKILL.md——阅读内容,不要根据名称猜测——并遵循其中说明。如果有多个合适的,选择描述中明确提到这项工作的那个;宿主说明中指定的系列路由技能优先于通用匹配项。
-
继续执行。 用一行说明你采用了哪项技能(或没有适用的技能)。
命令不可用时
如果没有 node/网络,或启动器提示 --find 未知(版本低于 1.55.0):直接搜索 front-matter 描述,只搜索一次,然后继续。
find -L ~/.agents/skills ~/.claude/skills ~/.claude/plugins/cache ~/.codex/skills \
-name SKILL.md -exec grep -ilE "^description:.*(<concept>|<concept>)" {} + 2>/dev/null
使用 find,不要使用 glob:如果 glob 没有匹配项,zsh 会中止命令。若宿主在其他位置维护自己的技能目录,也要将其加入搜索。多行 description: 会绕过此模式——若没有匹配项,将搜索范围扩大到整个文件。打开文件前,先阅读每个匹配项的 description:。如果没有找到任何内容,用一行说明,然后不使用技能直接完成任务;切勿反复搜索。
触发词
"which skill"、"find a skill"、«какой скилл»、«найди скилл»、«первый шаг»、任何任务的第一步。
边界
- 构建、审核或发布技能属于
make-skill,不属于此处。 - 在此找到的技能是你要遵循的说明——即使是尚未审核过的第三方技能,在运行其脚本之前,也必须先按照
make-skill中的安装审核流程检查(references/enterprise.md)。