Young Tries AI

Teach Claude Code to draw animated icons in one style with the Kubai Icons skill

For developers and creators who want product-specific animated icons in one consistent style. You install a skill into Claude Code or Codex, or install the ready-made React icon package instead.

Web and designFor developers, creators

Before you start

  • Claude Code (skills folder at ~/.claude/skills) or Codex (skills folder at ~/.agents/skills).
  • git installed, so you can clone the repository.
  • A model that can read images. The skill was developed and blind-tested with Claude Opus 5.5, which the authors recommend.
  • Node and npm, only if you want the ready-made icon packages in a React project.
  1. Clone the repository into your skills folder. In Codex, use ~/.agents/skills instead of ~/.claude/skills. You can also paste the install prompt from the next step into your agent and let it do the clone.

    Run in the terminal
    git clone https://github.com/kubai087/kubai-icons.git ~/.claude/skills/kubai-icons
  2. If you prefer, send this prompt to your agent. It clones the repo into the right skills folder, or pulls the latest version if it is already there, and confirms that SKILL.md exists.

    Paste into your agent
    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.
  3. Restart your agent so it picks up the skill. The skill asks for careful geometry and several rounds of looking at its own screenshots, so use a model that can read images. In Claude Code, the command below starts the recommended model.

    Start Claude Code with Opus 5.5
    claude --model claude-opus-5-5
  4. Describe what you need. The skill triggers on requests about icons, so you do not need to name it. The agent writes one line per feature, draws each icon after the closest existing one, then self-checks beside existing icons and repeats until every checklist item passes.

    Paste into your agent
    Read this repository and draw dynamic icons for its main features.
  5. The same skill handles additions and static exports. The README gives examples such as adding a scissors icon and a map icon, making an Export icon that matches the others, or exporting static SVG files. To start a set for your own product, the skill copies the engine, gallery and self-check into your project.

    Static SVG request
    Give me static SVG files I can drop into Figma.
  6. If you only want the finished icons, install the React package. It supports React 18+ and Next.js, including server rendering. Vue 3.3+/Nuxt, plain JavaScript (kubai-icons) and static SVG (kubai-icons-static) packages also exist.

    Run in the terminal
    npm install kubai-icons-react
  7. Import icons by their PascalCase names. Icons are 24px and follow the text color by default. The docs show a size prop (size={32}) and a color prop (color="#EC4899") that accepts any CSS color. Library names are kebab-case, such as cloud-rain, and PascalCase in code, such as CloudRain. You can find an icon and copy its code on icons.kubai.design.

    React import line
    import { Folder, MailPlus } from "kubai-icons-react";

Watch out for

  • Use a model that can read images. The skill relies on careful geometry and several rounds of looking at its own screenshots.
  • Codex uses ~/.agents/skills, not ~/.claude/skills, so clone into the right folder for your agent.
  • If your agent has no skill support, it can still read SKILL.md from the cloned folder and follow it.
  • Renaming or removing an icon is a breaking change in the packages, but redrawing one is not. New icons arrive in new releases, so update the package to get them.
  • CDN links that use @0 load the latest 0.x release. The CDN can take a while to switch over to a new release.

Questions

Which agents does it work with?
Claude Code, Codex and other coding agents. It was developed and blind-tested with Claude Opus 5.5, which the authors recommend. Other models, such as GPT in Codex, can use the same skill.
Do I have to name the skill when I ask?
No. The skill triggers on requests about icons, so describing what you need in plain words is enough.
Can I browse the icons without the skill?
Yes. The site icons.kubai.design lets you search by name, shape or meaning and recolor icons. You can copy the code or a prompt for your agent, download SVG or PNG, and save a collection as a ZIP.
How do I get newly added icons?
Update the package your project installs. For React, for example, run npm install kubai-icons-react@latest.
What license are the icons under?
The README states that the icon library is MIT licensed.

Sources

Based on