前言¶
在 Cursor、Claude Code、OpenClaw 等环境里，能力往往以 Skill（SKILL.md）形式挂在本地目录。技能越积越多，问题就变成：用户说「我想做海报」「有没有能分析大盘的工具」，Agent 该去哪个目录、哪个市场找对应能力？手工翻目录或逐个记 slug 都不现实。下面介绍的 Find Skills（坐标 @indiv-guipi/find-skills）面向「找技能 + 装技能」这一类对话，把场景理解、多源搜索和安装步骤写进 Skill 本身，让 Agent 按文档执行。
这是什么¶
Find Skills 是发布在 SkillHub 上的智能体技能，版本 1.0.0，上游来自 ClawHub（guipi888/find-skills），分类为 ai-agent，标签标明 requires_api_key=false（本身不依赖额外 API Key）。SkillHub 页面上的简介是：当用户询问「如何做 X」「找 X 的技能」「有能做……的吗」等问题时，帮助发现并安装合适的智能体技能。
维护与分发渠道包括：
- SkillHub：
https://www.skillhub.cn/skills/indiv-guipi/find-skills - 官方 API 页：
https://api.skillhub.cn/org-xyyuvez5/find-skills - 上游说明与完整流程：ClawHub
https://clawhub.ai/guipi888/find-skills
核心功能¶
以下能力均来自上述官方页面与上游文档，按执行顺序概括。
场景与关键词双模式触发¶
用户可以用自然语言描述需求（例如「我想做一个海报」），也可以说「安装技能」「find skills」「找个 skill」。Skill 会从表述里抽取任务意图、领域和中英文检索词，再进入搜索流程。
多层联合搜索¶
上游文档将搜索范围分为多层（合并去重后排序推荐）：
- 官方内置技能：扫描 WorkBuddy 内置技能目录，读取各技能
SKILL.md的 YAML frontmatter，做语义匹配。 - 本地已安装技能：扫描用户级目录（如
~/.workbuddy/skills/）与项目级.workbuddy/skills/。 - 远程市场：优先查本地 marketplace 缓存；若无匹配，再按顺序检索 SkillHub API、虾评市场、GitHub（含
SKILL.md的仓库/代码搜索），必要时回退到npx skills find与npx clawhub search。
远程 SkillHub 搜索示例（文档中的接口形态）：
curl -s "https://lightmake.site/api/v1/search?q=<URL-encoded 中文关键词>&limit=10"
curl -s "https://lightmake.site/api/v1/search?q=<URL-encoded English keywords>&limit=10"
低相关结果会按文档规则过滤（例如 score < 0.05 的结果丢弃）。
排序、说明与一键安装¶
合并结果后按「内置 → 已安装 → 各远程源」的优先级排序，输出技能名、一句话说明、匹配理由、来源与安装提示。用户确认安装远程技能时，文档要求先做客户端检测（通过 __CFBundleIdentifier 区分 CodeBuddy 与默认 WorkBuddy），再写入对应 skills 目录；支持从 marketplace 缓存复制、SkillHub/虾评/ClawHub 下载解压、GitHub 拉取以及 Vercel Skills CLI 等路径（详见上游各 Step 5 小节）。
安装与启用¶
在 SkillHub 生态中安装¶
SkillHub 页面给出的方式是：让 Agent 阅读安装说明并安装坐标 @indiv-guipi/find-skills：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@indiv-guipi/find-skills`。
若本机已有 skillhub CLI，应按当前 Agent 的 skills 目录安装（文档强调必须使用 --dir，否则默认 ./skills/ 可能不会被识别）：
command -v skillhub && skillhub --version
skillhub install find-skills --dir <你的 Agent skills 目录>
常用目录（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/ - WorkBuddy：
~/.workbuddy/skills/
CLI 未安装时，可按 SkillHub 文档执行官方安装脚本（完整安装或 --cli-only）。
在 OpenClaw / ClawHub 侧安装¶
ClawHub 页面提供的命令为：
openclaw skills install @guipi888/find-skills
与 SkillHub 坐标不同（@indiv-guipi/find-skills vs @guipi888/find-skills），对应同一上游技能在不同商店中的发布名，安装时以你当前使用的客户端文档为准。
典型用法¶
对话触发¶
| 用户表达 | 行为 |
|---|---|
| 「我想做 XXX」 | 场景理解后进入多层搜索 |
| 「帮我找 XXX 的技能」 | 直接搜索 |
| 「有没有能 XXX 的工具」 | 搜索并推荐 |
| 「这个场景应该用哪个技能」 | 匹配已安装与远程候选 |
输出形态（文档示例）¶
搜索完成后，助手按模板列出「官方·内置」「本地·已安装」「远程·可安装」等分区，并注明是否需安装、路径或安装命令。用户可说「安装第 N 个」进入 Step 5 的安装分支。
上游文档中的海报场景示例（节选逻辑）：先在本地已安装技能中命中图片生成类能力并可直接使用；同时在 SkillHub、ClawHub 列出可安装的专向技能，由用户选择是否安装。
适用场景与注意¶
适合谁
- 经常在对话里临时扩展能力、又不想手动维护一长串技能 slug 的开发者。
- 使用 WorkBuddy / CodeBuddy 或 OpenClaw 系客户端、希望统一从内置、本地与多个中文/英文市场找技能的用户。
限制与注意
- 环境绑定：内置扫描路径、marketplace 缓存、
__CFBundleIdentifier检测等写法面向 WorkBuddy/CodeBuddy 文档；在纯 Cursor 环境下，更现实的路径是 SkillHub CLI 安装本 Skill，并依赖其远程搜索与 Cursor 的~/.cursor/skills/目录，内置层可能无对应目录。 - 网络与认证：远程搜索依赖各市场 API；GitHub 代码搜索在文档中说明需要
GITHUB_TOKEN时配额更高；虾评安装流程文档要求先具备「虾评指南」技能并按其认证步骤操作。 - 与官方旧插件的关系：上游文档写明其意图覆盖并替代原
find-skills插件的触发范围；若你同时存在多个发现类 Skill，注意 description 与触发词是否冲突。 - 数据以页面为准：SkillHub API 页记录的本技能评分为 100000，下载 1318334，安装 75956（抓取时点）；商店数字会变动，引用时以安装时页面为准。
结尾¶
Find Skills 把「用户怎么说」映射到「去哪搜、装到哪、先推荐哪一个」，适合作为智能体栈里的技能发现入口。安装与行为细节以 SkillHub 与 ClawHub 官方页为准：
- https://www.skillhub.cn/skills/indiv-guipi/find-skills
- https://api.skillhub.cn/org-xyyuvez5/find-skills
- https://clawhub.ai/guipi888/find-skills
