Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

kubai-icons Skill

Repository ↗

by kubai087★ 1,0201 skills

Install

What it does

An agent skill that draws animated icons in one consistent style, for Claude Code, Codex and other coding agents. Comes with 2,600+ open-source icons for React, Vue and SVG, and a website to browse them.

  • Connects Instruction files the AI reads
  • Account or key No key found in README or SKILL.md
  • Category Design and web UI
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/kubai087-kubai-icons.svg)](https://mcp.popnx.com/en/skills/kubai087-kubai-icons)

Use together with

MCP servers that connect the AI to services for the same work

Next AI Draw.io

draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand

by DayuanJiangWidely used↓ 21.7K/wk★ 37.1K Stars for the whole repoUpdated 6 days ago

MCP · Connects a serviceRuns on your computer

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

by pascalorgWidely used↓ 1K/wk★ 25.6K Stars for the whole repoUpdated 2 days ago

MCP · Connects a serviceComputer or cloud✓ service owner · pascal.app

Semiotic

Verified React chart generation: select, validate, repair, render, and inspect charts through MCP.

by nteractWidely used↓ 8.5K/wk★ 2.7KUpdated today

MCP · Connects a serviceComputer or cloud

Similar Skills

Same kind of work, ordered like the Skills list

Compared with similar ones
This one
kubai-icons
impeccablediagram-designfrontend-slidesguizang-ppt-skill
Makerkubai087pbakauscathrynlaveryzarazhangruiop7418
Skills11111
GitHub stars1,020113,04268,29632,57930,091
Last code changeNov 19, 2026Nov 19, 2026Nov 19, 2026Jun 24, 2026Oct 30, 2026
License–Apache-2.0MITMITAGPL-3.0

1 skills (instruction sets) by kubai087 that an AI reads and follows · not an MCP server

How a Skill differs from MCP

MCP = the hands

Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.

Skill = the manual

A text file that teaches the AI how to do a task. It connects to nothing.

Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.

Works with

Claude CodeCodex

From the maker’s README and the folders in the repo

Install

Is it safe?

  • Who made it

    GitHub account kubai087 (person), 6 years old

  • Use and upkeep

    ★ 1,020 stars · code last changed Nov 19, 2026

  • Any scripts?

    1076 scripts that can run on a computer: badges/_disc.js, badges/_slash.js, badges/alert.js, badges/bolt.js and 1072 more

  • Uses the internet?

    Could not check every script (some are too large); read them first

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit ecccdd1 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

First: which AI do you use?

Pick your app and this page shows only how to install it there

Option 1Upload to claude.ai (web and app)

  1. Download from GitHub

    This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier

    Download from GitHub (whole repo) ↗

    Unzip it, then zip only the kubai-icons folder again. The ZIP must have a kubai-icons folder with SKILL.md at the top level, no loose files

  2. Open Skills on claude.ai and upload

    +Create skillUpload a skillpick kubai-icons.zip

    Open claude.ai/customize/skills ↗

  3. No Upload button? Turn on file creation first

    SettingsCapabilitiesCode execution and file creation

    Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free

Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)

Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)

Checked against official docs Nov 12, 2026 · Source: support.claude.com, support.claude.com, code.claude.com

Option 1Let Claude Code install it

Copy this sentence and paste it into a Claude Code chat

Where to install
Please install the skill kubai-icons from https://github.com/kubai087/kubai-icons (commit ecccdd1) for all my projects, at ~/.claude/skills/kubai-icons. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill kubai-icons from https://github.com/kubai087/kubai-icons (commit ecccdd1) into the project this chat is open in (at .claude/skills/kubai-icons). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Restart Claude Code, then type /kubai-icons or ask for a matching task and Claude picks it up

Checked against official docs Nov 12, 2026 · Source: code.claude.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.claude/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/kubai087/kubai-icons.git /tmp/popnx-skill-kubai087-kubai-icons-ecccdd1 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-kubai087-kubai-icons-ecccdd1/.' ~/.claude/skills/kubai-icons
  3. Restart Claude Code, then type /kubai-icons or ask for a matching task and Claude picks it up

Skills you install yourself work in the ChatGPT desktop app, Codex CLI and the Codex IDE extension · ChatGPT on the web and mobile cannot use skills you install yourself, only skills that come with a plugin from the directory

ChatGPT desktop app

The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills

Option 1Let ChatGPT install it

Open Codex in the ChatGPT desktop app and paste this sentence into the chat

Where to install
Please install the skill kubai-icons from https://github.com/kubai087/kubai-icons (commit ecccdd1) for all my projects, at ~/.agents/skills/kubai-icons. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill kubai-icons from https://github.com/kubai087/kubai-icons (commit ecccdd1) into the project this chat is open in (at .agents/skills/kubai-icons). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2Put the folder there yourself

Put the kubai-icons folder at ~/.agents/skills/kubai-icons

~ is your home folder ($HOME)

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.agents/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/kubai087/kubai-icons.git /tmp/popnx-skill-kubai087-kubai-icons-ecccdd1 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-kubai087-kubai-icons-ecccdd1/.' ~/.agents/skills/kubai-icons

After installing

  • ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
  • To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
  • Codex picks up newly installed skills by itself; if one does not show up, restart Codex

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

ChatGPT on the web and mobile

Skills you install yourself do not work here; only skills that come with a plugin from the directory

To use this skill with ChatGPT, use the ChatGPT desktop app as above

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

Option 1Let Codex install it

Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension

Where to install
Please install the skill kubai-icons from https://github.com/kubai087/kubai-icons (commit ecccdd1) for all my projects, at ~/.agents/skills/kubai-icons. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill kubai-icons from https://github.com/kubai087/kubai-icons (commit ecccdd1) into the project this chat is open in (at .agents/skills/kubai-icons). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.agents/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/kubai087/kubai-icons.git /tmp/popnx-skill-kubai087-kubai-icons-ecccdd1 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-kubai087-kubai-icons-ecccdd1/.' ~/.agents/skills/kubai-icons
  3. Restart Codex, then ask for a matching task; Codex lists the skill

Option 1Let Cursor install it

Copy this sentence and paste it into a Cursor chat

Where to install
Please install the skill kubai-icons from https://github.com/kubai087/kubai-icons (commit ecccdd1) for all my projects, at ~/.cursor/skills/kubai-icons. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill kubai-icons from https://github.com/kubai087/kubai-icons (commit ecccdd1) into the project this chat is open in (at .cursor/skills/kubai-icons). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

In Cursor’s Agent chat, type / and pick kubai-icons

Checked against official docs Nov 12, 2026 · Source: cursor.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.cursor/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/kubai087/kubai-icons.git /tmp/popnx-skill-kubai087-kubai-icons-ecccdd1 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-kubai087-kubai-icons-ecccdd1/.' ~/.cursor/skills/kubai-icons
  3. In Cursor’s Agent chat, type / and pick kubai-icons

Option 1Let the AI install it

For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat

Where to install
Please install the skill kubai-icons from https://github.com/kubai087/kubai-icons (commit ecccdd1) for all my projects, at ~/.claude/skills/kubai-icons (in Codex use ~/.agents/skills/kubai-icons, in Cursor ~/.cursor/skills/kubai-icons). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill kubai-icons from https://github.com/kubai087/kubai-icons (commit ecccdd1) into the project this chat is open in (at .claude/skills/kubai-icons; in Codex use .agents/skills/kubai-icons, in Cursor .cursor/skills/kubai-icons). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.

View on GitHub ↗

Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026

✓ Commands checked Nov 18, 2026

View the original SKILL.md

The text below comes from the maker’s repo, not from PopNx MCP

3,270 characters · Open the full file on GitHub

---
name: kubai-icons
description: 生成一套风格统一的功能图标,可以交付悬停时会形变的动态版(SVG + JS),也可以导出静态 SVG 文件,沿用 Lumno 书签文件夹图标的构造:后片、内容、前片分层,外描边,所有颜色从一个主色推导,两组关键帧的悬停动效,可切换色板。用户要做图标、功能图标、动态图标、静态 SVG 图标、icon set、带 hover 动效的图标,或要往这套图标里加新图标时使用。
license: Kubai Icons License (source-available). Complete terms in LICENSE.
metadata:
  version: "1.2.0"
  display_name: "Kubai 动态图标"
  display_name_en: "Kubai Icons"
  description_zh: "按同一种风格稳定地画出功能图标:文件夹式的前后分层、外描边、一个主色推导全部颜色,悬停时做物体本身会做的动作;也可以导出静态 SVG。"
  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."
---

# Kubai Icons

这个 skill 自带完整的实现:引擎、一整套范例图标、展示页、自检脚本和静态导出脚本。你的工作是按规则写新图标,不是重写引擎。

## 包里有什么

- `PROMPT.md`:全部设计规则,每一条都是硬性要求。动手前完整读一遍。
- `src/engine.js`:引擎。颜色推导、外描边遮罩、厚度带渐变、投影和内发光滤镜、插值动画、色板都在这里。直接复用,不要改。
- `src/icons.js`:范例图标。新图标按同样的格式追加。
- `src/app.js`、`index.html`:展示页。`ORDER` 决定展示哪些图标、按什么顺序排。
- `scripts/check.mjs`:自检脚本。在无头 Chrome 里截出静止、悬停、悬停过程的中间帧、24px、28px 和所有色板,读出每一页的脚本报错,并用 `scripts/measure.js` 对照 `PROMPT.md` 里能量化的规则逐个测量,结果写进 `findings.md`。临时文件都放在输出目录里,跑完自动清理。
- `scripts/measure.js`:测量规则的代码,由自检脚本加载。量的是动作有没有跳帧、结束时是否平稳停下,尺寸和居中,分层,线宽,过小的细节,细缝,被盖住的描边露头,尖角接缝处的毛刺,以及落在背景上却没有描边的边。
- `scripts/export.mjs`:静态导出。把图标渲染成不依赖脚本和样式表的独立 SVG 文件,可以指定色板、主色和静止或悬停状态。

## 流程

1. 读 `PROMPT.md`。
2. 确定交付形式。用户没说清楚时先问一句:
   - 动态(默认):SVG + JS,悬停时形变,靠 `src/engine.js` 在页面里运行。适合网页和能跑 JS 的界面。
   - 静态:独立的 `.svg` 文件,没有动效,任何地方都能用:设计工具、原生 App、文档、`<img>`。用户提到"切图""SVG 文件""放进 Figma""App 里用"等,就是要静态。
   - 两者都要:按动态做,最后再导出一份静态。
3. 确定在哪里做:
   - 新做一套:把本 skill 的 `index.html`、`src/`、`scripts/` 复制到目标位置(一个新目录或新仓库),在那份副本里工作。保留每个文件开头的版权声明;`PROMPT.md` 和 `SKILL.md` 只留在 skill 里,不要复制进去(见 `LICENSE` 第 3 条)。
   - 往已有的一套里加:直接在那份 `src/icons.js` 里追加。
   - 往 kubai-icons 仓库的开源图标库里加:每个图标在 `icons/` 下单独一个文件,格式、命名、角标、关键词和各语言名字见 `docs/authoring.md`,自检用 `node tools/check.mjs --only 名字 --with folder,mail,download`。规则仍以 `PROMPT.md` 为准。
   - 只要静态:同样复制一份到工作目录里画,最后只把导出的 SVG 交给用户。
4. 读产品代码,列出功能。动态版每个功能写一句"物体 + 悬停动作";静态版只需要确定物体(`PROMPT.md` 第 1 节)。
5. 每写一个图标之前,先在 `src/icons.js` 里找一两个结构最接近的范例读一遍(例如翻开的东西看信封和日历,切出前片的看下载和上传,会旋转的看齿轮和星标),照它们的写法来。
6. 把名字加进 `src/app.js` 的 `ORDER`。用不到的范例,不放进 `ORDER` 就不会显示。
7. 运行自检,把新图标和几个现有图标放在一起看:

   ```bash
   node scripts/check.mjs --only 新图标A,新图标B --with 文件夹,邮件,下载
   ```

   截图和 `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` 就够了。
8. 改到全部通过后,更新 README 里提到的图标数量,以及展示页每个断点的列数(列数要能整除图标总数,断点可以增删)。
9. 要静态时,导出到用户指定的目录,并告诉用户用的是哪个色板:

   ```bash
   node scripts/export.mjs --only 新图标A,新图标B --palette 彩色 --out 目标目录
   ```

   `--palette` 按名字选色板(彩色、蓝灰、青瓷、薄荷、薰衣草、杏色、黑色),`--accent #hex` 把所有图标换成一个主色,`--state hover` 导出悬停结束时的样子,`--size` 设定像素尺寸,`--pad` 给投影留出边距。每个图标一个 `名字.svg`。

## 环境

- Node 18 以上,以及 Chrome。浏览器路径可以用环境变量 `CHROME` 覆盖。
- 所有检查都在无头模式下进行,不会打开任何可见窗口,也不会动用户正在用的浏览器。

---

Copyright (c) 2026 Kubai087. Licensed under the Kubai Icons License; see LICENSE.

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

From GitHub

GitHub stars
1,020
Maker
kubai087
License
No license stated This repo states no license. By default the author keeps all rights: ask before you share it or use it commercially.
Last code change
Nov 19, 2026
SKILL.md files in the repo (including translated copies and templates)
1
Topics
agent-skills, ai-agents, animated-icons, animation, claude, claude-skill, codex, design-system, hover-effects, icon-set, icons, react