前言¶
在 Cursor、Claude Code 等环境里,模型自带的联网能力往往依赖当前会话是否开启搜索、或是否接好了 MCP。用户一句「查一下」「帮我找」若不能稳定映射到同一套流程,Agent 要么拒绝、要么凭训练数据作答,时效性和可核对性都打折。
下面介绍 SkillHub 上的「网页搜索技能」:用通用 SKILL.md 约定触发词与行为,让 Agent 在用户表达检索意图时执行网页搜索并汇总结果,把「要不要搜、怎么搜」写进技能定义,而不是每次靠临场判断。
这是什么¶
「网页搜索技能」是社区发布者 user_c5d687fe 在 SkillHub 上架的 Agent Skill,坐标为 @user_c5d687fe/web-search-skill-v2,当前版本 1.0.0,分类为 knowledge-management,来源标记为 community。
官方简介概括为:执行网页搜索并汇总结果;当用户出现「搜索」「查一下」「找一下」「帮我查」「搜索一下」等意图时触发此技能。页面标签标明 requires_api_key=false,即按 SkillHub 元数据无需单独配置 API Key 即可安装使用(具体搜索后端以实现为准,以技能包内 SKILL.md 为准)。
SkillHub 页面:https://www.skillhub.cn/skills/user_c5d687fe/web-search-skill-v2
API 坐标页:https://api.skillhub.cn/user_c5d687fe/web-search-skill-v2
核心功能¶
依据官方简介与 SkillHub 展示信息,可核实的能力如下:
- 意图触发:识别用户自然语言中的检索意图(如「搜索」「查一下」「找一下」「帮我查」「搜索一下」等表述),在满足条件时启用本技能,而不是仅依赖模型是否「记得」去联网。
- 网页搜索:针对用户问题发起网页搜索(具体检索通道与参数由技能包内说明定义)。
- 结果汇总:将检索到的网页信息整理后回复用户,便于在对话中直接引用与核对。
技能本体遵循通用 SKILL.md 格式,便于在支持 Skills 的客户端中安装与版本管理。
安装与启用¶
安装流程以 SkillHub 官方安装文档为准:https://skillhub.cn/install/skillhub.md。Skill 详情页给出的安装提示为:按上述文档安装坐标 @user_c5d687fe/web-search-skill-v2。
1、检查 SkillHub CLI¶
先确认本机是否已有 skillhub:
command -v skillhub && skillhub --version
若未安装,可使用官方一键脚本(完整安装含 CLI 与默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装到当前 Agent 的 skills 目录¶
官方强调:安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录,否则默认会装到 ./skills/,客户端可能无法加载。
skillhub install @user_c5d687fe/web-search-skill-v2 --dir <skills 目录>
常用客户端的 skills 路径(摘自 SkillHub 安装文档):
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
示例(Cursor):
skillhub install @user_c5d687fe/web-search-skill-v2 --dir ~/.cursor/skills/
安装完成后,按你所用客户端的要求重启或刷新 Agent,使新技能被加载。Codex CLI、Claude Code 与 Cursor 的差异主要体现在 skills 目录路径;安装命令形式一致,均为 skillhub install 加 --dir。
也可将下面提示交给支持 Skills 的 AI,由其按 install 文档完成安装:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c5d687fe/web-search-skill-v2。
典型用法¶
本技能的设计重点是用自然语言触发,而非固定 CLI 子命令。安装并启用后,在对话中直接使用官方简介列出的意图表述即可,例如:
- 「搜索一下 Rust 2024 版本发布说明」
- 「帮我查 Cursor Skills 的安装目录」
- 「找一下 SkillHub 上 knowledge-management 分类还有哪些技能」
Agent 识别到检索意图后,应走技能定义的搜索与汇总流程,并在回复中体现来自网页检索的信息(而非仅依赖模型内部知识)。具体检索范围、条数、是否附带链接等细节,以安装后的 SKILL.md 与技能包内脚本为准。
适用场景与注意¶
适合谁
- 经常在 Agent 对话里做资料查证、文档核对、新闻或版本信息查询的开发者。
- 希望把「何时搜索、如何汇总」固化成技能,减少每次手动开联网或配 MCP 的操作。
- 使用 Cursor、Claude Code、Codex 等已支持 SkillHub 安装路径的环境。
需要注意
- 网页搜索结果受检索源与索引时效影响,重要决策仍应点开原始页面核对。
- 安装路径错误是常见坑:务必
--dir到当前客户端的 skills 目录。 - SkillHub 元数据中的评分、下载量会随时间变化;撰写时页面显示评分为 100000、下载 3729(以 SkillHub 实时页面为准)。
- 本技能标注
requires_api_key=false;若后续版本或子依赖要求密钥,以技能包更新说明为准。
结尾¶
「网页搜索技能」把检索意图与「搜索 + 汇总」行为写进 SKILL,适合作为知识管理类技能栈里的一块基础能力。需要安装或查看详情时,可打开 SkillHub 页面:
https://www.skillhub.cn/skills/user_c5d687fe/web-search-skill-v2