@nucleoicons/skills

CLI to install and update Nucleo MCP + icon skills on your machine.

Once installed, your AI coding tool can help you use Nucleo icons in code. Typical uses:

• Search icons by name or idea across your licensed families (core, ui, sharp, micro, pixel)
• Pick an icon and get the right React component or SVG for your project
• Customize icons when inserting them (color, secondary color, stroke width, duo opacity, corners)

Ask your editor naturally, for example: “find a settings icon in Nucleo” or “insert the home icon as a React component.”

Requires Node.js 20+.

Install

npx @nucleoicons/skills setup --target react --tools cursor

Required for setup: --target (react or vanilla) and --tools (cursor, claude, codex).

npx @nucleoicons/skills setup --target react --tools cursor
npx @nucleoicons/skills setup --target vanilla --tools cursor,claude

Setup installs the package under your user home (~/.nucleo/skills) and configures the editors you choose (skills + MCP, no manual config step).

Reload MCP in your editor, then ask something like:

What Nucleo icon families do I have?

Update

npx @nucleoicons/skills update

npx @nucleoicons/skills update --check   # only report whether an update is available

After updating, reload MCP in your editor again.

Editors

| Tool | --tools value | Auto-configured | | ----------- | --------------- | --------------- | | Cursor | cursor | ~/.cursor/mcp.json + ~/.cursor/skills/ | | Claude Code | claude | ~/.claude.json + ~/.claude/skills/ | | Codex | codex | ~/.codex/config.toml + ~/.agents/skills/ |