前言¶

在 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 会从表述里抽取任务意图、领域和中英文检索词，再进入搜索流程。

多层联合搜索¶

上游文档将搜索范围分为多层（合并去重后排序推荐）：

1. 官方内置技能：扫描 WorkBuddy 内置技能目录，读取各技能 SKILL.md 的 YAML frontmatter，做语义匹配。
2. 本地已安装技能：扫描用户级目录（如 ~/.workbuddy/skills/）与项目级 .workbuddy/skills/。
3. 远程市场：优先查本地 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），对应同一上游技能在不同商店中的发布名，安装时以你当前使用的客户端文档为准。

典型用法¶

对话触发¶

输出形态（文档示例）¶

搜索完成后，助手按模板列出「官方·内置」「本地·已安装」「远程·可安装」等分区，并注明是否需安装、路径或安装命令。用户可说「安装第 N 个」进入 Step 5 的安装分支。

上游文档中的海报场景示例（节选逻辑）：先在本地已安装技能中命中图片生成类能力并可直接使用；同时在 SkillHub、ClawHub 列出可安装的专向技能，由用户选择是否安装。

适用场景与注意¶

适合谁

• 经常在对话里临时扩展能力、又不想手动维护一长串技能 slug 的开发者。
• 使用 WorkBuddy / CodeBuddy 或 OpenClaw 系客户端、希望统一从内置、本地与多个中文/英文市场找技能的用户。

限制与注意

1. 环境绑定：内置扫描路径、marketplace 缓存、__CFBundleIdentifier 检测等写法面向 WorkBuddy/CodeBuddy 文档；在纯 Cursor 环境下，更现实的路径是 SkillHub CLI 安装本 Skill，并依赖其远程搜索与 Cursor 的 ~/.cursor/skills/ 目录，内置层可能无对应目录。
2. 网络与认证：远程搜索依赖各市场 API；GitHub 代码搜索在文档中说明需要 GITHUB_TOKEN 时配额更高；虾评安装流程文档要求先具备「虾评指南」技能并按其认证步骤操作。
3. 与官方旧插件的关系：上游文档写明其意图覆盖并替代原 find-skills 插件的触发范围；若你同时存在多个发现类 Skill，注意 description 与触发词是否冲突。
4. 数据以页面为准：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