Kubai Icons
一个让编码智能体按统一风格绘制动画图标的技能,附带 2,800+ 个可直接使用的开源图标。
- Star 数
- ★ 1.1k
- 最近更新
- 今天
- License
- NOASSERTION
- 主语言
- JavaScript
- FA 评分
- 48/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 前端团队已经使用 Claude Code 或 Codex,希望为新产品的每个功能快速配齐风格统一的动画图标
- 不适合
- 需要完全可自由修改、再分发规则文件的团队(PROMPT.md、SKILL.md 不可改造后发布)
- 只想拿来即用静态图标、不需要动画与技能的团队
- 无法让模型读取截图、只能用小模型的低配工作流
- 官网
- icons.kubai.design ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 [email protected](2026-11-20)近 7 天每天 +35.0 ★
- 源码审查
- 48/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Kubai Icons 是一个面向 Claude Code、Codex 等编码智能体的技能(skill),核心文件是 PROMPT.md 里的绘制规则、src/engine.js 里的颜色推导与动画引擎,以及 scripts/check.mjs 的无头自检脚本。智能体读入规则后,为产品功能逐条设计“日常物件 + 悬停动作”,参照最接近的 66 个示例图标复用引擎绘制,再截图比对尺寸、描边、图层和配色,直到自检通过。配套图标库包含 2,800+ 个 MIT 许可的图标,通过 kubai-icons-react、kubai-icons-vue、kubai-icons(框架无关 API 与 <kubai-icon> Web Component)和 kubai-icons-static 四个 npm 包交付,也支持一个 <script> 标签从 CDN 按需加载。图标为双关键帧结构(静止与悬停),所有渐变、描边与阴影由单一强调色派生,跟随 currentColor 无需脚本即可换色。官网 icons.kubai.design 提供 16 种语言的检索、换色、代码与提示词复制、SVG/PNG 下载和收藏打包。
技能工作流是:读取 PROMPT.md 规则,为每个功能写一行“物件 + 悬停动作”描述(如“文件夹打开”“锁弹开”),从 src/icons.js 的 66 个示例中挑结构最接近的一个,复用 src/engine.js 的颜色推导、外描边、渐变、阴影、插值与调色板函数作画,然后运行 node scripts/check.mjs 在无头 Chrome 中渲染静止、悬停及中间每一帧,覆盖 24px、28px 与全部调色板,并排对比已有图标,反复修正直到清单全部通过。输出方面,scripts/export.mjs 可将技能自带图标导出为 SVG,支持 --palette(彩色、蓝灰、青瓷、薄荷、薰衣草、杏色、黑色)、--accent #hex、--state hover、--size、--pad、--out 等参数。图标库侧,每个图标是 icons/ 下的一个模块,npm run build 生成四个包,npm run validate 校验命名、元数据与标记,tools/check.mjs 生成联系表。运行时,React/Vue 组件可接收 size、color、variant="soft"、badgeColor、trigger="parent" 等属性,悬停、聚焦、点击或父元素触发播放动画。
- 前端团队已经使用 Claude Code 或 Codex,希望为新产品的每个功能快速配齐风格统一的动画图标
- 设计系统维护者需要一套单一强调色即可整体换肤、且悬停有语义动作(文件夹打开、日历翻页)的图标集
- React 18+/Next.js 或 Vue 3/Nuxt 项目想直接 npm 安装现成动画图标,而不是自己写 SVG 动画
- 需要把图标导出为静态 SVG 交给 Figma 或原生应用,或通过 CDN 单脚本按需加载的静态站点
- 开源项目作者向图标库提交手绘或技能生成的图标,或通过官网提交页生成 issue 而无需发 PR
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm i kubai-icons-react
- 配置文件
~/.claude/skills~/.agents/skills~/.claude/skills/kubai-icons~/.agents/skills/kubai-icons- 运行环境
- Node.js 18+
如何安装或部署这个 Agent?
把下面这段指令发给你的编码智能体(Claude Code 中用 ~/.claude/skills,Codex 中用 ~/.agents/skills):
Install the Kubai Icons skill for me:
clone https://github.com/kubai087/kubai-icons into your skills folder as kubai-icons
(~/.claude/skills in Claude Code, ~/.agents/skills in Codex;
if it's already there, pull the latest version instead),
make sure SKILL.md exists in that folder, and tell me when it's ready.也可以手动克隆或解压 release 包:
# Claude Code
git clone https://github.com/kubai087/kubai-icons.git ~/.claude/skills/kubai-icons
# Codex
git clone https://github.com/kubai087/kubai-icons.git ~/.agents/skills/kubai-iconsunzip kubai-icons-v*.zip -d ~/.claude/skills/只使用图标库时,按框架安装对应 npm 包:
npm i kubai-icons-react如何使用这个 Agent?
安装技能后重启智能体,用自然语言提需求即可触发,例如“为这个仓库的主要功能画一组动态图标”。使用图标库:
import { Folder, CalendarCheck } from "kubai-icons-react";
// 24px,跟随文字颜色
<Folder />
// 自定义尺寸、颜色、柔和风格与绿色徽标
<CalendarCheck size={32} color="#22C55E" variant="soft" badgeColor="semantic" />
// 由按钮悬停触发
<button data-kubai-trigger>
<Folder size={18} trigger="parent" /> Open
</button>无构建步骤时用 CDN 脚本:
<script type="module" src="https://cdn.jsdelivr.net/npm/kubai-icons@0/dist/cdn/element.js"></script>
<kubai-icon name="folder-plus" size="32" color="#6366F1"></kubai-icon>运行自检需 Node.js 18+ 与 Chrome:
node scripts/check.mjs --only 剪刀,地图 --with 文件夹,邮件,下载导出静态 SVG:
node scripts/export.mjs --only 文件夹,日历 --palette 薄荷 --out icons/这个 Agent 有哪些优点和局限?
- 规则、引擎与自检形成闭环:智能体画出图标后会用无头 Chrome 截图逐帧比对并自我修正,而不是一次成稿
- 2,800+ 个 MIT 许可图标覆盖 React、Vue、框架无关 API、Web Component 与静态 SVG 五种交付形态,选型不受框架锁定
- 所有渐变、描边和阴影由单一强调色经 CSS 派生,图标跟随 currentColor 换色,无需脚本重绘
- 每个图标是独立的副作用无关 ES 模块,支持服务端渲染与按需加载,运行时只在动画播放时生效
- 许可证明确区分:图标 MIT、技能源码可见、生成图标归使用者所有且商用免署名
- 技能许可禁止分发修改或翻译后的 PROMPT.md、SKILL.md,也不能以其他名义再发布,限制了二次分发
- 技能依赖能读图的模型,README 明确推荐 Claude Opus 5.5;能力较弱的模型效果未经验证
- 自检与导出需要 Node.js 18+/20+ 与 Chrome,导出脚本中的图标名和调色板参数为中文,对非中文用户不直观
- 网站与工具目录(site/、tools/、tests/、docs/)为保留所有权利,不可复制或自行托管
- 仓库标注 NOASSERTION,实际许可需对照 LICENSE、LICENSE-ICONS、LICENSE-SITE 等多份文件才能厘清
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Kubai Icons 当前 | 48 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 1.1k | 今天 | JavaScript | Codex · Claude Code |
| CopilotKit | 64 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 39k | 今天 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| FormKit | 49 · 缺口较多 | Agent 插件 / 技能免费版 + 付费版 | ★ 4.8k | 今天 | TypeScript | Codex · Claude Code |
| Monocolor Editorial Print(单色编辑部印刷风技能) | 69 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 3.7k | 2 个月前 | Python | Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
SKILL.md 明确要求复用引擎、不改 engine.js,自检在无头 Chrome 中运行且不触碰用户浏览器,权限面较窄(least_privilege 2)。但安装指令让 agent 自行 clone 仓库到 skills 目录并 pull 最新版,属于对未知来源代码的自动执行,缺少显式确认步骤(user_confirmation 1)。数据流方面仅说明本地运行,未说明是否联网、是否上传图标或截图(data_flow_transparency 1)。敏感数据处理无专门说明(1)。依赖安全仅见 package.json 与 CI,未见审计或锁定说明(1)。外部副作用限于写 check-out/ 与导出目录,未说明覆盖或清理策略(1)。回滚仅靠 git pull,无版本回退指引(1)。来源归属清晰:README 与 LICENSE 说明构造源自 Lumno 书签文件夹图标,并区分各文件许可(source_attribution 2)。
SKILL.md 流程、PROMPT.md 规则、check.mjs 自检与 CI 相互一致,测试覆盖 CDN 构建、渲染与 API 校验,自洽性较好(self_consistency 2)。依赖可用性只声明 Node 18+/20+ 与 Chrome,未给出锁定版本或离线方案,Chrome 路径依赖环境变量(dependency_availability 1)。失败信息方面 check.mjs 会读脚本报错,但文档未描述具体错误文案或排障步骤(failure_messages 1)。
面向 Claude Code、Codex 等编码 agent,覆盖动态/静态/两者都要三种交付场景,受众与场景明确(audience_and_scenarios 2)。SKILL.md 明确边界:只写新图标、不改引擎、PROMPT.md 与 SKILL.md 不复制进项目(capability_boundaries 2)。触发描述列出图标、功能图标、动态图标、静态 SVG、icon set 等关键词,触发精度较好(trigger_precision 2)。环境适配要求 Node 与 Chrome,且推荐 Claude Opus 5.5 等能读图的模型,对其他模型适配性有限(environment_fit 1)。
README 结构清晰,分安装、使用、构建、贡献、许可,信息架构良好(information_architecture 2)。安装说明含一键提示词、手动 clone、zip 与 marketplace 包多种方式(install_notes 2)。命名规范在 docs/authoring.md 中明确 kebab-case、方向后缀、badge 后缀保留(naming_stability 2)。示例与 FAQ 丰富,含代码片段、CLI 选项表与折叠说明(examples_and_faq 2)。已知限制仅提及需能读图的模型,未系统列出限制(known_limitations 1)。许可分层清晰但为 source-available 非开源,NOASSERTION 元数据与 LICENSE 文本存在张力,仍给 2(license 2)。版本号见 SKILL.md metadata 1.0.1 与 changeset,但无 CHANGELOG 文件(versioning_changelog 1)。维护责任由单一作者承担,无治理或 SLA 说明(maintenance_responsibility 1)。
输出为可交付的 SVG/JS 图标与静态文件,含自检截图,可用性较好(output_usability 2)。相对通用图标库,提供统一风格与悬停动效的差异化价值(marginal_value 2)。成本上需 Node、Chrome、多轮截图自检与较强模型,投入较高,成本收益一般(cost_benefit 1)。
README 声称 2,800+ 图标、盲测等,但包内仅见 66 个范例,数量声明无法在样本内核实(claim_traceability 1)。测试与 CI 可交叉印证部分行为,但盲测结论无独立证据(cross_source_corroboration 1)。文档大体区分事实与推荐,但“blind-tested”等表述与推断边界略模糊(fact_inference_separation 1)。
- 安装提示词让 agent 自动 clone 并 pull 未知来源仓库到 skills 目录,建议先人工审阅再执行。
- 文档未说明自检与导出是否联网、是否上传图标或截图,数据流不透明。
- 依赖仅声明 Node 与 Chrome,无锁定版本或离线方案,环境差异可能导致自检失败。
- 许可为 source-available 且元数据为 NOASSERTION,商用与再分发前需逐条核对 LICENSE。
- README 声称 2,800+ 图标与盲测结论,包内样本仅 66 个范例,无法核实。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Patch Changes - Add 7 two-tone icons: terminal, code, brackets, umbrella, cloud-rain, cloud-snow and backpack. ([#118](https://github.com/kubai087/kubai-icons/pull/118)) - Add 5 two-tone icons: user-round, images, playlist, id-badge and radio. ([#118](https://github.com/kubai087/kubai-icons/pull/118)) - Add 12 two-tone icons: circle-minus, circle-dot, checkbox, plus-square, more-horizontal, loader, appearance, rotate-ccw, log-in, sidebar, zoom-in and zoom-out. ([#108](https://github.com/kubai087/kubai-icons/pull/108)) …在 GitHub 查看 ↗ -
发布说明摘录
Patch Changes - Add 7 two-tone icons: terminal, code, brackets, umbrella, cloud-rain, cloud-snow and backpack. ([#118](https://github.com/kubai087/kubai-icons/pull/118)) - Add 5 two-tone icons: user-round, images, playlist, id-badge and radio. ([#118](https://github.com/kubai087/kubai-icons/pull/118)) - Add 12 two-tone icons: circle-minus, circle-dot, checkbox, plus-square, more-horizontal, loader, appearance, rotate-ccw, log-in, sidebar, zoom-in and zoom-out. ([#108](https://github.com/kubai087/kubai-icons/pull/108)) …在 GitHub 查看 ↗ -
发布说明摘录
Patch Changes - Add 7 two-tone icons: terminal, code, brackets, umbrella, cloud-rain, cloud-snow and backpack. ([#118](https://github.com/kubai087/kubai-icons/pull/118)) - Add 5 two-tone icons: user-round, images, playlist, id-badge and radio. ([#118](https://github.com/kubai087/kubai-icons/pull/118)) - Add 12 two-tone icons: circle-minus, circle-dot, checkbox, plus-square, more-horizontal, loader, appearance, rotate-ccw, log-in, sidebar, zoom-in and zoom-out. ([#108](https://github.com/kubai087/kubai-icons/pull/108)) …在 GitHub 查看 ↗
常见问题
技能画出的图标版权归谁?
一定要用 Claude Opus 5.5 吗?
不用智能体,能直接用图标吗?
图标动画是怎么触发的?
能导出静态 SVG 给 Figma 或原生应用吗?
Kubai Icons 官网是什么?
Kubai Icons 免费吗?
Kubai Icons 开源吗?
Kubai Icons 安全吗?
Kubai Icons 还在维护吗?
Kubai Icons 是谁开发的?
谢谢反馈,我们会据此改进页面。