Skip to content
Back to search

kubai-icons

SkillWorks with Claude CodeGitHub

生成一套风格统一的功能图标,可以交付悬停时会形变的动态版(SVG + JS),也可以导出静态 SVG 文件,沿用 Lumno 书签文件夹图标的构造:后片、内容、前片分层,外描边,所有颜色从一个主色推导,两组关键帧的悬停动效,可切换色板。用户要做图标、功能图标、动态图标、静态 SVG 图标、icon set、带 hover 动效的图标,或要往这套图标里加新图标时使用。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 15 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/kubai087/kubai-icons with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/kubai087/kubai-icons'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kubai087--kubai-icons/badge.svg)](/listings/kubai087--kubai-icons)

HTML

<a href="/listings/kubai087--kubai-icons"><img src="/api/listings/kubai087--kubai-icons/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Copy this into your agent and send it:

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.

Restart your agent, and the skill is ready. An agent without skill support can read `SKILL.md` from the cloned folder and follow it.

> [!TIP] > The skill asks for careful geometry and several rounds of looking at its own screenshots, so use a capable model that can read images. It was developed and blind-tested with **Claude Opus 5.5**, which we recommend. Other models, such as GPT in Codex, can use the same skill. In Claude Code, run `claude --model claude-opus-5-5`.

<details> <summary><strong>Install it yourself</strong></summary>

<br />

Clone the repository into your skills folder. In Codex, use `~/.agents/skills` instead.

git clone https://github.com/kubai087/kubai-icons.git ~/.claude/skills/kubai-icons

Or download `kubai-icons-v*.zip` from the [latest release](https://github.com/kubai087/kubai-icons/releases/latest) and unzip it there:

unzip kubai-icons-v*.zip -d ~/.claude/skills/

The agent picks the skill up the next time it starts.

Publishing to a skill marketplace that asks for a version and display names in `SKILL.md`? Upload `kubai-icons-v*-platform.zip` from the same release. It carries those fields at the top of the frontmatter.

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 65 lines
  1. ---
  2. name: kubai-icons
  3. description: 生成一套风格统一的功能图标,可以交付悬停时会形变的动态版(SVG + JS),也可以导出静态 SVG 文件,沿用 Lumno 书签文件夹图标的构造:后片、内容、前片分层,外描边,所有颜色从一个主色推导,两组关键帧的悬停动效,可切换色板。用户要做图标、功能图标、动态图标、静态 SVG 图标、icon set、带 hover 动效的图标,或要往这套图标里加新图标时使用。
  4. license: Kubai Icons License (source-available). Complete terms in LICENSE.
  5. metadata:
  6. version: "1.2.0"
  7. display_name: "Kubai 动态图标"
  8. display_name_en: "Kubai Icons"
  9. description_zh: "按同一种风格稳定地画出功能图标:文件夹式的前后分层、外描边、一个主色推导全部颜色,悬停时做物体本身会做的动作;也可以导出静态 SVG。"
  10. description_en: "Draws functional icons in one consistent style: folder-like layers, outside outlines, every colour derived from one accent, and hover motion the object itself would make. Can also export static SVG."
  11. ---
  12. # Kubai Icons
  13. 这个 skill 自带完整的实现:引擎、一整套范例图标、展示页、自检脚本和静态导出脚本。你的工作是按规则写新图标,不是重写引擎。
  14. ## 包里有什么
  15. - `PROMPT.md`:全部设计规则,每一条都是硬性要求。动手前完整读一遍。
  16. - `src/engine.js`:引擎。颜色推导、外描边遮罩、厚度带渐变、投影和内发光滤镜、插值动画、色板都在这里。直接复用,不要改。
  17. - `src/icons.js`:范例图标。新图标按同样的格式追加。
  18. - `src/app.js`、`index.html`:展示页。`ORDER` 决定展示哪些图标、按什么顺序排。
  19. - `scripts/check.mjs`:自检脚本。在无头 Chrome 里截出静止、悬停、悬停过程的中间帧、24px、28px 和所有色板,读出每一页的脚本报错,并用 `scripts/measure.js` 对照 `PROMPT.md` 里能量化的规则逐个测量,结果写进 `findings.md`。临时文件都放在输出目录里,跑完自动清理。
  20. - `scripts/measure.js`:测量规则的代码,由自检脚本加载。量的是动作有没有跳帧、结束时是否平稳停下,尺寸和居中,分层,线宽,过小的细节,细缝,被盖住的描边露头,尖角接缝处的毛刺,以及落在背景上却没有描边的边。
  21. - `scripts/export.mjs`:静态导出。把图标渲染成不依赖脚本和样式表的独立 SVG 文件,可以指定色板、主色和静止或悬停状态。
  22. ## 流程
  23. 1. 读 `PROMPT.md`。
  24. 2. 确定交付形式。用户没说清楚时先问一句:
  25. - 动态(默认):SVG + JS,悬停时形变,靠 `src/engine.js` 在页面里运行。适合网页和能跑 JS 的界面。
  26. - 静态:独立的 `.svg` 文件,没有动效,任何地方都能用:设计工具、原生 App、文档、`<img>`。用户提到"切图""SVG 文件""放进 Figma""App 里用"等,就是要静态。
  27. - 两者都要:按动态做,最后再导出一份静态。
  28. 3. 确定在哪里做:
  29. - 新做一套:把本 skill 的 `index.html`、`src/`、`scripts/` 复制到目标位置(一个新目录或新仓库),在那份副本里工作。保留每个文件开头的版权声明;`PROMPT.md` 和 `SKILL.md` 只留在 skill 里,不要复制进去(见 `LICENSE` 第 3 条)。
  30. - 往已有的一套里加:直接在那份 `src/icons.js` 里追加。
  31. - 往 kubai-icons 仓库的开源图标库里加:每个图标在 `icons/` 下单独一个文件,格式、命名、角标、关键词和各语言名字见 `docs/authoring.md`,自检用 `node tools/check.mjs --only 名字 --with folder,mail,download`。规则仍以 `PROMPT.md` 为准。
  32. - 只要静态:同样复制一份到工作目录里画,最后只把导出的 SVG 交给用户。
  33. 4. 读产品代码,列出功能。动态版每个功能写一句"物体 + 悬停动作";静态版只需要确定物体(`PROMPT.md` 第 1 节)。
  34. 5. 每写一个图标之前,先在 `src/icons.js` 里找一两个结构最接近的范例读一遍(例如翻开的东西看信封和日历,切出前片的看下载和上传,会旋转的看齿轮和星标),照它们的写法来。
  35. 6. 把名字加进 `src/app.js` 的 `ORDER`。用不到的范例,不放进 `ORDER` 就不会显示。
  36. 7. 运行自检,把新图标和几个现有图标放在一起看:
  37. ```bash
  38. node scripts/check.mjs --only 新图标A,新图标B --with 文件夹,邮件,下载
  39. ```
  40. 截图和 `findings.md` 在 `check-out/`。脚本报出错误时先修错误;再看 `findings.md`,每一条都指出一个很可能的问题,到截图上确认后修掉,确认是有意为之的可以保留(例如悬停时盖子抬出画布),在图标定义里写 `allow: { 规则名: '理由' }` 声明,它会单独列在 `findings.md` 的 Allowed 部分,不再计入问题;没确认过的不要声明。最后逐条对照 `PROMPT.md` 第 10 节的清单检查。往复类动作看 `frames.png`;查细缝时加 `--scale 3`;查浅主色上的标记时加 `--accent #F59E0B`,把所有图标换成同一个主色。不加 `--only` 就检查整套。静态版看 `rest.png`、`size-24.png`、`size-28.png` 和 `palettes.png` 就够了。
  41. 8. 改到全部通过后,更新 README 里提到的图标数量,以及展示页每个断点的列数(列数要能整除图标总数,断点可以增删)。
  42. 9. 要静态时,导出到用户指定的目录,并告诉用户用的是哪个色板:
  43. ```bash
  44. node scripts/export.mjs --only 新图标A,新图标B --palette 彩色 --out 目标目录
  45. ```
  46. `--palette` 按名字选色板(彩色、蓝灰、青瓷、薄荷、薰衣草、杏色、黑色),`--accent #hex` 把所有图标换成一个主色,`--state hover` 导出悬停结束时的样子,`--size` 设定像素尺寸,`--pad` 给投影留出边距。每个图标一个 `名字.svg`。
  47. ## 环境
  48. - Node 18 以上,以及 Chrome。浏览器路径可以用环境变量 `CHROME` 覆盖。
  49. - 所有检查都在无头模式下进行,不会打开任何可见窗口,也不会动用户正在用的浏览器。
  50. ---
  51. Copyright (c) 2026 Kubai087. Licensed under the Kubai Icons License; see LICENSE.
README.md · README · 257 lines
  1. <p align="center">
  2. <img src="site/src/app/icon.svg" width="72" height="72" alt="" />
  3. </p>
  4. <h1 align="center">Kubai Icons</h1>
  5. <p align="center">
  6. <strong>An agent skill that draws animated icons in one consistent style.</strong><br />
  7. Plus 2,800+ open-source icons drawn with it, for React, Vue and the web.
  8. </p>
  9. <p align="center">
  10. <a href="#install-the-skill">Install the skill</a> ·
  11. <a href="https://icons.kubai.design/icons/">Browse the icons</a> ·
  12. <a href="#use-the-icons">Use them in code</a> ·
  13. <a href="https://icons.kubai.design/docs/">Docs</a>
  14. </p>
  15. <p align="center">
  16. <img src="assets/hover.webp" alt="Sixteen icons opening one after another on hover: a folder opens, an envelope unseals, a calendar turns a page, a lock springs open, a gear turns" />
  17. </p>
  18. ## What's included
  19. | Part | What you get |
  20. | --- | --- |
  21. | **Agent skill** | The rules, engine and self-check that draw every icon in one hand. Give Claude Code, Codex or another coding agent a product, and it draws the icons that product needs. |
  22. | **Icon library** | 2,800+ icons: nearly 900 objects, plus badged and slashed "off" versions. For React, Vue, plain JavaScript, web components and static SVG. MIT licensed. |
  23. | **Website** | [icons.kubai.design](https://icons.kubai.design/), in 16 languages. Search every icon by name, shape or meaning, recolor it, copy its code or a prompt for your agent, download it as SVG or PNG, and save a collection as a ZIP. |
  24. ## Install the skill
  25. Copy this into your agent and send it:
  26. ```text
  27. Install the Kubai Icons skill for me:
  28. clone https://github.com/kubai087/kubai-icons into your skills folder as kubai-icons
  29. (~/.claude/skills in Claude Code, ~/.agents/skills in Codex;
  30. if it's already there, pull the latest version instead),
  31. make sure SKILL.md exists in that folder, and tell me when it's ready.
  32. ```
  33. Restart your agent, and the skill is ready. An agent without skill support can read `SKILL.md` from the cloned folder and follow it.
  34. > [!TIP]
  35. > The skill asks for careful geometry and several rounds of looking at its own screenshots, so use a capable model that can read images. It was developed and blind-tested with **Claude Opus 5.5**, which we recommend. Other models, such as GPT in Codex, can use the same skill. In Claude Code, run `claude --model claude-opus-5-5`.
  36. <details>
  37. <summary><strong>Install it yourself</strong></summary>
  38. <br />
  39. Clone the repository into your skills folder. In Codex, use `~/.agents/skills` instead.
  40. ```bash
  41. git clone https://github.com/kubai087/kubai-icons.git ~/.claude/skills/kubai-icons
  42. ```
  43. Or download `kubai-icons-v*.zip` from the [latest release](https://github.com/kubai087/kubai-icons/releases/latest) and unzip it there:
  44. ```bash
  45. unzip kubai-icons-v*.zip -d ~/.claude/skills/
  46. ```
  47. The agent picks the skill up the next time it starts.
  48. Publishing to a skill marketplace that asks for a version and display names in `SKILL.md`? Upload `kubai-icons-v*-platform.zip` from the same release. It carries those fields at the top of the frontmatter.
  49. </details>
  50. ## Ask for icons
  51. Describe what you need in plain words. The skill triggers on requests about icons, so you don't need to name it.
  52. - "Read this repository and draw dynamic icons for its main features."
  53. - "Add a scissors icon and a map icon to this set."
  54. - "We need an icon for Export that matches the others."
  55. - "Give me static SVG files I can drop into Figma."
  56. The agent then:
  57. 1. Reads the rules and writes one line per feature: an everyday object and what it does on hover ("a folder opens", "a lock springs open").
  58. 2. Draws each icon after the closest existing one, reusing the engine.
  59. 3. Runs the self-check beside existing icons, compares sizes, outlines, layers and colors, and repeats until every item on the checklist passes.
  60. To start a set for your own product, the skill copies the engine, gallery and self-check into your project and works there.
  61. <p align="center">
  62. <img src="assets/skill.webp" alt="Six icons on hover: an alarm clock rings, a notebook opens, a scan line sweeps a QR code, a door opens to an exit arrow, a calculator key presses, a compass needle settles north" />
  63. </p>
  64. <p align="center"><sub>Drawn by a fresh Claude session that had nothing but <code>SKILL.md</code> and <code>PROMPT.md</code>. Each blind test closes the gaps it finds in the rules.</sub></p>
  65. ## Use the icons
  66. | Package | For |
  67. | --- | --- |
  68. | [`kubai-icons-react`](packages/react) | React 18+ and Next.js, server rendering included |
  69. | [`kubai-icons-vue`](packages/vue) | Vue 3 and Nuxt |
  70. | [`kubai-icons`](packages/core) | Any page: a framework-free API and the `<kubai-icon>` web component |
  71. | [`kubai-icons-static`](packages/static) | Standalone SVG files for `<img>`, design tools, native apps and CDNs |
  72. ```bash
  73. npm i kubai-icons-react
  74. ```
  75. ```tsx
  76. import { Folder, CalendarCheck } from "kubai-icons-react";
  77. // 24px, follows the text color
  78. <Folder />
  79. // Any CSS color, the soft look, a green badge
  80. <CalendarCheck size={32} color="#22C55E" variant="soft" badgeColor="semantic" />
  81. // Plays when the button is hovered
  82. <button data-kubai-trigger>
  83. <Folder size={18} trigger="parent" /> Open
  84. </button>
  85. ```
  86. No build step? One script tag loads any icon on demand:
  87. ```html
  88. <script type="module" src="https://cdn.jsdelivr.net/npm/kubai-icons@0/dist/cdn/element.js"></script>
  89. <kubai-icon name="folder-plus" size="32" color="#6366F1"></kubai-icon>
  90. ```
  91. - **Moves like the object.** A folder opens, an envelope unseals, a calendar turns to the next day. Hover, focus, a tap, a parent element or your own state can play it.
  92. - **One accent, every color.** Gradients, outlines, marks and shadows derive from one color through CSS, so icons follow `currentColor` and recolor without script.
  93. - **Pay for what you use.** One side-effect-free ES module per icon, pre-rendered markup, server rendering, and a tiny runtime that only runs while an icon moves.
  94. Find an icon and copy its code on the [website](https://icons.kubai.design/icons/). Guides for every package are in the [documentation](https://icons.kubai.design/docs/).
  95. Building a native app in Go? [Kubai Icons for MyGo](https://kubai.yldm.ai/) is a community port for [MyGo](https://github.com/egoist/mygo), maintained by [yldm-tech](https://github.com/yldm-tech/mygo-kubai-icons) rather than this project.
  96. ## How an icon is built
  97. Every icon is a back piece, optional white content and a front piece, like a folder holding a sheet of paper. Outlines sit outside the fill, so shapes keep their full size. Every gradient, outline and shadow derives from one accent color, so a single value repaints the whole icon. Each part has exactly two keyframes, rest and hover.
  98. <p align="center">
  99. <img src="assets/palettes.webp" alt="Eight icons moving through seven palettes: one color per icon, five clear tones, and black" />
  100. </p>
  101. The complete rules are in [`PROMPT.md`](PROMPT.md).
  102. ## Reference
  103. <details>
  104. <summary><strong>What the skill ships</strong></summary>
  105. <br />
  106. | Part | What it does for the model |
  107. | --- | --- |
  108. | [`PROMPT.md`](PROMPT.md) | The rules, each one a hard requirement: canvas and keylines, layers, corners and outlines, light, color, marks and motion. |
  109. | [`src/engine.js`](src/engine.js) | Color derivation, outside outlines, gradients, shadows, interpolation and palettes, already built. New icons reuse them instead of reinventing them. |
  110. | [`src/icons.js`](src/icons.js) | 66 worked examples. Each new icon starts from the closest one in structure. |
  111. | [`scripts/check.mjs`](scripts/check.mjs) | A headless self-check: rest, hover, every moment in between, 24px, 28px and every palette, plus a list of findings against the rules that can be measured ([`scripts/measure.js`](scripts/measure.js)). |
  112. `index.html` opens a local gallery of these 66 examples. The full library is on the [website](https://icons.kubai.design/icons/).
  113. </details>
  114. <details>
  115. <summary><strong>Export static SVG</strong></summary>
  116. <br />
  117. This exports the skill's own icons, whose names and palettes are in Chinese. For the library, download from the [website](https://icons.kubai.design/icons/) or use [`kubai-icons-static`](packages/static).
  118. ```bash
  119. node scripts/export.mjs --only 文件夹,日历 --palette 薄荷 --out icons/
  120. ```
  121. | Option | What it does |
  122. | --- | --- |
  123. | `--palette` | 彩色 (default), 蓝灰, 青瓷, 薄荷, 薰衣草, 杏色 or 黑色. |
  124. | `--accent #hex` | Paints every icon in one accent color. |
  125. | `--state hover` | Exports the end of the hover instead of the rest pose. |
  126. | `--size 96` | Width and height in pixels. |
  127. | `--pad 2.5` | Room around the canvas, in icon units, so the shadow isn't cut off. |
  128. | `--out dir` | Where the files go; `export/` by default. |
  129. </details>
  130. <details>
  131. <summary><strong>Run the self-check</strong></summary>
  132. <br />
  133. Needs Node.js 18 or later and Chrome. Everything runs headless.
  134. ```bash
  135. node scripts/check.mjs --only 剪刀,地图 --with 文件夹,邮件,下载
  136. ```
  137. | Option | What it does |
  138. | --- | --- |
  139. | `--only` | Checks only these icons. Without it, the whole set. |
  140. | `--with` | Adds existing icons beside them for comparison. |
  141. | `--accent #F59E0B` | Paints every icon in one accent color, to check marks on light accents. |
  142. | `--scale 3` | Renders every sheet at 3×, to look for seams. |
  143. | `--out dir` | Writes the screenshots somewhere other than `check-out/`. |
  144. Besides the screenshots it writes `findings.md`: each icon measured against the rules that can be measured, such as motion that stops dead or jumps, size and centring, line widths, thin gaps, outlines that peek out or meet in a spike, and edges with no outline. Each finding points at a likely problem to confirm on the screenshots.
  145. `CHROME` overrides the browser path. The animations in this README come from `node scripts/media.mjs`, which also needs `ffmpeg` and `img2webp`.
  146. </details>
  147. <details>
  148. <summary><strong>Work on the library and website</strong></summary>
  149. <br />
  150. Needs Node.js 20 or later; the contact sheets also need Chrome.
  151. ```bash
  152. npm install
  153. npm run build # every package, from icons/ and badges/
  154. npm run validate # names, metadata and markup of every icon
  155. npm test
  156. node tools/check.mjs --only folder,mail --with download # contact sheets in check-out/lib
  157. npm run audit # scores every icon against the rules, in check-out/audit
  158. npm run site:dev # the website
  159. ```
  160. Each icon is one module in [`icons/`](icons); [`docs/authoring.md`](docs/authoring.md) explains the format, and [`docs/review.md`](docs/review.md) how icons are reviewed. The website is a static Next.js export in [`site/`](site).
  161. </details>
  162. ## Contributing
  163. - **Improve the skill.** Report a rule that left you guessing, run a blind test with a fresh session, or fix a script. Rule changes start from an issue.
  164. - **Add an icon.** Draw it with the skill or by hand as a module in `icons/`, check it with `tools/check.mjs`, and open a pull request. Merged icons are credited to you on the website.
  165. - **Submit an icon without a pull request.** The [submission page](https://icons.kubai.design/icons/submit/) checks your files and prepares an issue.
  166. - **Request an icon.** Open an [icon request](https://github.com/kubai087/kubai-icons/issues/new?template=icon-request.yml) with the object and what it should do on hover.
  167. See [CONTRIBUTING.md](CONTRIBUTING.md) and the [code of conduct](CODE_OF_CONDUCT.md). Security issues go through [SECURITY.md](SECURITY.md).
  168. ## License
  169. | Part | License | In short |
  170. | --- | --- | --- |
  171. | Icons (`icons/`, `badges/`) and the four packages | [MIT](LICENSE-ICONS) | Use, change and redistribute them in any project, commercial or not. |
  172. | The skill | [Kubai Icons License](LICENSE) | Source-available. See below. |
  173. | Website (`site/`, `tools/`, `tests/`, `docs/`) | [All rights reserved](LICENSE-SITE) | You may read the source and run it to prepare a contribution, but not copy or host it. |
  174. Under the Kubai Icons License:
  175. - **Your icons are yours.** Icons you make with the skill belong to you, for any use including commercial, with no credit required.
  176. - **Ship the engine with them.** You may copy the engine, the gallery, the example icons and the self-check into your own icon set's project, change them, and ship that project, as long as the copyright notice at the top of each file stays.
  177. - **Use and share the skill freely.** You may run it for any work, change it for your own use, and share exact, unmodified copies for free.
  178. - **Don't republish it as something else.** Don't distribute a modified or translated version of the rules (`PROMPT.md`, `SKILL.md`), sell the skill, remove its notices, or present it under another name or as your own work.
  179. [LICENSING.md](LICENSING.md) lists which file falls under which license. The Kubai and Lumno names and logos are not licensed for reuse. The construction comes from the bookmark folder icon in [Lumno](https://github.com/kubai087/lumno-extension).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.