前言¶
给 Skill、MCP 服务或小型产品配图标时，常见做法是打开几个图标站手动翻页，或硬编码某个固定图标集里的名字。Iconify 把大量开源图标集统一成一套 HTTP API，但 Agent 仍需要明确「搜什么、优先哪几个库、SVG 地址怎么拼」。图标推荐Skill（坐标 @user_c9af6e01/iconify-search）把搜索接口、库优先级和输出格式写进 SKILL.md，让模型按同一套规则搜索、推荐并给出可直接使用的 SVG 链接。该 Skill 在 SkillHub 分类为 design-media，标签 requires_api_key=false，无需额外 API Key。
这是什么¶
图标推荐Skill 是社区来源（community）的 Agent Skill，当前版本 1.0.0，由发布者 user_c9af6e01 维护。一句话定位：通过 Iconify 的公开 API 搜索、推荐并获取 SVG 图标资源，适用于 Agent、MCP、Skill、Logo、Favicon 等场景。
与「自己记几个 curl 示例」相比，它把支持的图标库列表、搜索 URL、SVG 路径规则和推荐优先级固化在技能说明里，减少每次对话里重复交代格式。
核心功能¶
依据技能包内 SKILL.md，已核实的能力包括：
- 关键词搜索：调用 Iconify 搜索接口，按概念词检索图标。
- 多图标库覆盖：文档中列出的库包括 Lucide、Tabler Icons、Material Symbols、Material Design Icons (MDI)、Phosphor、Carbon、Simple Icons、Boxicons、Heroicons。
- SVG 直链：根据
prefix:icon-name规则生成https://api.iconify.design/{prefix}/{name}.svg形式的地址。 - 推荐优先级：在多个候选中优先 lucide → tabler → material-symbols → mdi → ph → simple-icons。
- 结构化输出：要求返回图标名称、SVG 地址和推荐理由（文档内给出
lucide:bot、tabler:robot等示例）。
技能元数据中的 argument-hint 为 [关键词]，表示典型触发方式是带搜索词使用。
安装与启用¶
下面介绍两种在 SkillHub 上公布的安装方式；装好后需让当前 Agent 能读到对应 skills 目录（部分客户端需重启后生效）。
方式一：SkillHub CLI¶
先确认本机是否已有 CLI（参见 SkillHub 安装说明）：
command -v skillhub && skillhub --version
安装 图标推荐Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。Cursor 常用路径为 ~/.cursor/skills/。
skillhub install iconify-search --namespace user_c9af6e01 --dir ~/.cursor/skills/
搜索验证时，CLI 会显示坐标 @user_c9af6e01/iconify-search 及同名安装命令。
方式二：让 AI 按官方话术安装¶
SkillHub 技能页提供的提示词为：请根据 https://skillhub.cn/install/skillhub.md，安装 @user_c9af6e01/iconify-search。
将上述内容发给已接入 Skill 安装的 Agent，由它按文档完成 CLI 检查、下载与目录配置。
各客户端 skills 目录（节选）¶
以下路径来自 SkillHub 安装文档，按你实际使用的客户端选择其一：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
未在官方文档中单独列出的工具，请以该工具自己的 skills 路径为准，安装命令中的 --dir 与之对齐即可。
典型用法¶
技能说明把接口与地址规则写得很短，可直接复现。
1. 搜索图标¶
在浏览器或终端请求搜索接口，将 query 换成你的关键词：
https://api.iconify.design/search?query=关键词
例如查找与「机器人」相关的图标时，可将 query 设为 robot（具体返回以 Iconify 实时结果为准）。
2. 拼 SVG 地址¶
图标名采用 前缀:名称 形式。文档示例：lucide:bot 对应：
https://api.iconify.design/lucide/bot.svg
另一示例：tabler:robot 对应：
https://api.iconify.design/tabler/robot.svg
3. 在对话中触发 Skill¶
启用该 Skill 后，用自然语言描述场景即可，例如：「为 MCP 服务找一个机器人图标，优先 Lucide，给出 SVG 链接。」模型应按 SKILL.md 中的推荐优先级与输出要求，返回名称、URL 和简短推荐理由。
适用场景与注意¶
适合谁
- 正在给 Agent、MCP、Skill 元数据或站点 Favicon 选图标的开发者。
- 希望统一走 Iconify、又不想每次手写搜索与 URL 规则的团队。
限制与注意
- 能力边界以技能包
SKILL.md为准；未在文档中承诺的能力（例如本地批量打包、框架组件代码生成）不要默认包含在本 Skill 内。 - 图标版权与许可因图标集而异，用于品牌 Logo 或对外产品前，请在 Iconify 对应图标集说明中核对许可。
- SkillHub 页面统计（截至资料抓取）：评分 100000，下载 1646 次；以 SkillHub 技能页 为准会随时间变化。
- 依赖 Iconify 公共服务，离线或限网环境需自行评估可用性。
结尾¶
图标推荐Skill 把 Iconify 搜索与 SVG 直链规则封装成 Agent 可执行的说明，适合在 Skill、MCP 与小型前端资源场景里快速定稿图标。官方入口：SkillHub 技能页，API 资源地址：https://api.skillhub.cn/user_c9af6e01/iconify-search。
