Kubai Icons

An agent skill that draws animated icons in one consistent hand, plus 2,800+ open-source icons ready for React, Vue and the web.

Stars
★ 1.1k
Last updated
today
License
NOASSERTION
Primary language
JavaScript

At a glance

How it runs
Agent plugin / skillLibrary / SDK
Works with
Portable with changesCodex · Claude Code
Cost
Free software; you pay for model usage
Setup effort
Low · running in minutes
You'll need
Node.js 18+ (self-check)Chrome (headless self-check)Node.js 20+ (library and website build)npm packages kubai-icons-react / kubai-icons-vue / kubai-icons / kubai-icons-staticShell / CLINetwork accessLocal filesystem
Typical use
Front-end teams already running Claude Code or Codex who want icons for every feature of a new product drawn in one consistent style
Not a fit if
  • Teams that need to freely modify and redistribute the rules files (PROMPT.md, SKILL.md)
  • Projects that only need plain static icons, not agent-drawn animation
  • Workflows stuck on models that cannot read images, since the skill self-checks screenshots
Website
icons.kubai.design ↗ set on GitHub
Maintenance
Commits in the last 30 dayslast commit 2026-11-20latest release [email protected] (2026-11-20)+35.0 ★/day over 7 days

What does this agent do, and when should you use it?

Kubai Icons is a skill for coding agents such as Claude Code and Codex, built from three pieces: drawing rules in PROMPT.md, a color-derivation and animation engine in src/engine.js, and a headless self-check in scripts/check.mjs. The agent reads the rules, writes one line per feature pairing an everyday object with a hover action, starts from the closest of 66 worked examples, and reuses the engine to draw; it then screenshots the result beside existing icons and repeats until its checklist passes. The companion library ships 2,800+ MIT-licensed icons through four npm packages — kubai-icons-react, kubai-icons-vue, kubai-icons (framework-free API plus the <kubai-icon> web component) and kubai-icons-static — and can also be loaded from a CDN with a single script tag. Every icon is two keyframes, rest and hover, and all gradients, outlines and shadows derive from one accent color via CSS, so icons follow currentColor without script. The website at icons.kubai.design offers search, recoloring, code and prompt copying, SVG/PNG download and ZIP collections in 16 languages.

The skill flow: read PROMPT.md, write one line per feature ("a folder opens", "a lock springs open"), pick the structurally closest of the 66 examples in src/icons.js, and draw by reusing src/engine.js for color derivation, outside outlines, gradients, shadows, interpolation and palettes. Then run node scripts/check.mjs, which renders rest, hover and every in-between moment at 24px and 28px across every palette in headless Chrome, compares sizes, outlines, layers and colors against existing icons, and iterates. For static output, scripts/export.mjs exports the skill's own icons with --palette (彩色, 蓝灰, 青瓷, 薄荷, 薰衣草, 杏色, 黑色), --accent #hex, --state hover, --size, --pad and --out. On the library side, each icon is one module under icons/; npm run build compiles all four packages, npm run validate checks names, metadata and markup, and tools/check.mjs produces contact sheets. At runtime, React and Vue components accept size, color, variant="soft", badgeColor and trigger="parent", and animation can play on hover, focus, tap, a parent element or your own state.

  1. Front-end teams already running Claude Code or Codex who want icons for every feature of a new product drawn in one consistent style
  2. Design-system maintainers who need a set that repaints from a single accent color and whose hovers carry meaning (a folder opens, a calendar turns)
  3. React 18+/Next.js or Vue 3/Nuxt projects that would rather npm-install animated icons than hand-write SVG animation
  4. Teams exporting static SVG for Figma or native apps, or loading icons on demand from a CDN on a static site
  5. Open-source contributors adding an icon by hand or via the skill, or filing one through the website submission page without a pull request

Key setup facts

Pulled from the install and usage notes below. The project README has the current values.

Install / run
  • npm i kubai-icons-react
Config files
~/.claude/skills ~/.agents/skills ~/.claude/skills/kubai-icons ~/.agents/skills/kubai-icons
Runtime
Node.js 18+

How do you install or deploy this agent?

Send this to your coding agent (use ~/.claude/skills in Claude Code, ~/.agents/skills in Codex):

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.

Or clone and unzip the release archive yourself:

# 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-icons
unzip kubai-icons-v*.zip -d ~/.claude/skills/

If you only want the library, install the package for your framework:

npm i kubai-icons-react

How do you use this agent?

Restart your agent after installing the skill, then describe what you need in plain words, e.g. "Read this repository and draw dynamic icons for its main features." To use the library:

import { Folder, CalendarCheck } from "kubai-icons-react";

// 24px, follows the text color
<Folder />

// Custom size and color, the soft look, a green badge
<CalendarCheck size={32} color="#22C55E" variant="soft" badgeColor="semantic" />

// Plays when the button is hovered
<button data-kubai-trigger>
  <Folder size={18} trigger="parent" /> Open
</button>

No build step? Load any icon on demand:

<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>

Run the self-check (needs Node.js 18+ and Chrome):

node scripts/check.mjs --only 剪刀,地图 --with 文件夹,邮件,下载

Export static SVG:

node scripts/export.mjs --only 文件夹,日历 --palette 薄荷 --out icons/

What are this agent's strengths and limitations?

Pros
  • Rules, engine and self-check form a loop: the agent screenshots and compares its own frames in headless Chrome instead of one-shotting a drawing
  • 2,800+ MIT-licensed icons span React, Vue, a framework-free API, a web component and static SVG, so you are not tied to one framework
  • Every gradient, outline and shadow derives from one accent color through CSS, so icons follow currentColor and recolor without script
  • Each icon is a side-effect-free ES module with pre-rendered markup and SSR support; the tiny runtime only runs while an icon moves
  • Licensing is explicit: icons are MIT, generated icons belong to you with no credit required, even commercially
Limitations
  • The skill license forbids distributing modified or translated PROMPT.md and SKILL.md, or republishing the skill under another name
  • The skill needs a model that can read images; the README recommends Claude Opus 5.5 and other models are not benchmarked
  • Self-check and export need Node.js 18+/20+ and Chrome, and export flags and palettes are named in Chinese
  • The website and tooling directories (site/, tools/, tests/, docs/) are all-rights-reserved and cannot be copied or hosted
  • The repository is marked NOASSERTION; figuring out the real terms takes cross-reading LICENSE, LICENSE-ICONS and LICENSE-SITE

How does this agent compare with similar options?

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
Kubai Icons This agent 48 · Major gaps Agent plugin / skillFree + model costs ★ 1.1k today JavaScript Codex · Claude Code
CopilotKit 64 · Some gaps CLIFreemium ★ 39k today TypeScript Codex · Claude Code · OpenAI API · Claude API
FormKit 49 · Major gaps Agent plugin / skillFreemium ★ 4.8k 1d ago TypeScript Codex · Claude Code
Monocolor Editorial Print 69 · Some gaps Agent plugin / skillFree + model costs ★ 3.7k 2mo ago Python Claude Code

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Major gaps
48/ 100 5-point scale 2.4 / 5
This review covers the source as of Nov 10, 2026. The project has shipped 35 stable release(s) since, which have not been re-reviewed. The score and verdict describe the reviewed version only. Recent releases ↓
Trust 12/29
Reliability 6/14
Adaptability 10/18
Convention 10/18
Effectiveness 7/13
Verifiability 3/8
Why each dimension lost points
Trust12 / 29 · 2.1/5

SKILL.md requires reusing the engine and not modifying engine.js, and the self-check runs headless Chrome without touching the user's browser, so the permission surface is narrow (least_privilege 2). However, the install prompt tells the agent to clone the repo into the skills folder and pull the latest version automatically, with no explicit confirmation step for executing unknown-source code (user_confirmation 1). Data flow is described only as local; there is no statement on network access or uploading icons/screenshots (data_flow_transparency 1). No dedicated sensitive-data handling (1). Dependency security is limited to package.json and CI, with no audit or lockfile discussion (1). External effects are confined to check-out/ and export dirs, but overwrite/cleanup policy is unstated (1). Rollback relies on git pull with no version-pinning guidance (1). Source attribution is clear: README and LICENSE credit the Lumno bookmark folder icon and separate per-file licenses (source_attribution 2).

Reliability6 / 14 · 2.1/5

SKILL.md flow, PROMPT.md rules, check.mjs and CI are mutually consistent, and tests cover CDN build, rendering and API validation, so self-consistency is good (self_consistency 2). Dependency availability only states Node 18+/20+ and Chrome, with no pinned versions or offline path, and Chrome path depends on an env var (dependency_availability 1). Failure messages: check.mjs reads script errors, but docs do not describe specific error text or troubleshooting (failure_messages 1).

Adaptability10 / 18 · 2.8/5

Targets Claude Code, Codex and other coding agents, covering dynamic/static/both delivery scenarios, so audience and scenarios are clear (audience_and_scenarios 2). SKILL.md sets boundaries: only write new icons, do not modify the engine, do not copy PROMPT.md/SKILL.md into projects (capability_boundaries 2). Trigger description lists icons, functional icons, dynamic icons, static SVG, icon set, etc., giving good trigger precision (trigger_precision 2). Environment fit requires Node and Chrome and recommends image-capable models like Claude Opus 5.5, limiting fit for other models (environment_fit 1).

Convention10 / 18 · 2.8/5

README is well structured with install, usage, build, contributing and license sections (information_architecture 2). Install notes cover a one-shot prompt, manual clone, zip and marketplace package (install_notes 2). Naming rules in docs/authoring.md specify kebab-case, direction suffixes and reserved badge suffixes (naming_stability 2). Examples and FAQ are rich, with code snippets, CLI option tables and collapsible sections (examples_and_faq 2). Known limitations mention only the need for an image-capable model, without a systematic list (known_limitations 1). Licensing is layered and clear but source-available rather than open source, and the NOASSERTION metadata conflicts with the LICENSE text, still scored 2 (license 2). Version appears in SKILL.md metadata 1.0.1 and changesets, but there is no CHANGELOG file (versioning_changelog 1). Maintenance rests on a single author with no governance or SLA (maintenance_responsibility 1).

Effectiveness7 / 13 · 2.7/5

Outputs are deliverable SVG/JS icons and static files with self-check screenshots, giving good usability (output_usability 2). Compared with generic icon libraries it offers a differentiated consistent style with hover motion (marginal_value 2). Cost is high: Node, Chrome, multiple screenshot self-check rounds and a capable model, so cost-benefit is moderate (cost_benefit 1).

Verifiability3 / 8 · 1.9/5

README claims 2,800+ icons and blind tests, but the packet shows only 66 examples, so the count claim cannot be verified from the sample (claim_traceability 1). Tests and CI corroborate some behavior, but blind-test conclusions have no independent evidence (cross_source_corroboration 1). Docs mostly separate facts from recommendations, though phrases like 'blind-tested' blur the inference boundary (fact_inference_separation 1).

Risks and how to mitigate them
  • The install prompt has the agent auto-clone and pull an unknown-source repo into the skills folder; review manually before running.
  • Docs do not state whether self-check or export access the network or upload icons/screenshots, so data flow is opaque.
  • Dependencies only declare Node and Chrome with no pinned versions or offline path, so environment differences may break the self-check.
  • License is source-available with NOASSERTION metadata; verify LICENSE terms before commercial use or redistribution.
  • README claims 2,800+ icons and blind-test results, but the packet shows only 66 examples, so these cannot be verified.
Evidence confidence: Low Reviewed Nov 10, 2026 Reviewed revision 25c5bdc5ea9e New commits since this review; the score may not cover them
See the full review method →
Maintain this project? Add the FARS badge to your README

The badge shows the current review score and verdict and links back to this page. It refreshes about once an hour after a re-review.

FARS

[![FARS review](https://followagents.com/badge/kubai-icons.svg)](https://followagents.com/en/agents/kubai-icons)
<a href="https://followagents.com/en/agents/kubai-icons"><img src="https://followagents.com/badge/kubai-icons.svg" alt="FARS review"></a>

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. [email protected]
    Release notes excerpt
    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)) …
    View on GitHub ↗
  2. [email protected]
    Release notes excerpt
    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)) …
    View on GitHub ↗
  3. [email protected]
    Release notes excerpt
    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)) …
    View on GitHub ↗

FAQ

Who owns the icons the skill draws?
You do. The Kubai Icons License states that icons you make with the skill belong to you for any use including commercial, with no credit required.
Do I have to use Claude Opus 5.5?
No. The skill installs in Claude Code and Codex, but the workflow has the model review its own screenshots repeatedly, so a model that can read images is required. The README says it was developed and blind-tested with Claude Opus 5.5.
Can I use the icons without an agent?
Yes. Install kubai-icons-react, kubai-icons-vue, kubai-icons or kubai-icons-static, or load the <kubai-icon> web component from jsDelivr with one script tag.
How does the animation start?
Each part has only a rest and a hover keyframe. You can play it on hover, focus, a tap, a parent element (trigger="parent" with data-kubai-trigger) or your own state, and the runtime only runs while an icon moves.
Can I export static SVG for Figma or native apps?
Yes. scripts/export.mjs takes icon names, palette, accent color, hover state, size and padding; note the skill's own icons and palettes are named in Chinese. For the full library, download from the website or use kubai-icons-static.
Is Kubai Icons free?
The software is free, but Kubai Icons calls an AI model, and you pay that model provider for usage (or run a local model).
Is Kubai Icons open source?
The source code is public on GitHub (kubai087/kubai-icons), but the repository does not declare a recognised licence, so the rights to reuse or modify it are unclear. Ask the author or check the README before building on it.
Is Kubai Icons safe to use?
FollowAgents' FARS review (Nov 10, 2026) scored Kubai Icons 12/29 on trust and safety. None of the eight safety controls the review checks for was missing outright. The repository has changed since that review.
Is Kubai Icons still maintained?
Yes. The latest commit on GitHub is from 2026-11-20, within the last 30 days. The latest release is [email protected] (2026-11-20).
What is Kubai Icons's official website?
The project's GitHub repository lists https://icons.kubai.design as its website. That link is set by the repository owner; the source code itself is on GitHub (kubai087/kubai-icons).
Was this page helpful?
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related concepts