@its-thepoe/iconsax
v1.0.0
Published
Agent Skill: install and use Iconsax correctly in React, React Native, and TypeScript projects.
Maintainers
Readme
@its-thepoe/iconsax
Agent Skill — installs and uses Iconsax correctly in React, React Native, and TypeScript projects without hallucinated package names, JSX usage, or icon exports.
What it does
Guides agents through the correct Iconsax setup: install iconsax-react for React projects, use the React Native package only for React Native projects, import exact named icon components, and render icons as direct components.
It also includes a resolver script that reads the installed Iconsax package and searches real icon names so agents stop guessing names like SearchIcon when the actual export is SearchNormal.
Why it’s useful
- Prevents wrong package names and fake icon imports.
- Finds exact icon component names from the installed Iconsax package.
- Keeps icon-only buttons accessible with
aria-label. - Encourages
currentColorso icons follow app theme styles. - Avoids wildcard icon imports that can hurt bundles.
Use when
- You want to add Iconsax to a React, Next.js, Vite, React Native, or TypeScript project.
- An agent is failing with missing Iconsax imports.
- You need the correct icon name for a concept like
search,user add, orarrow right. - You want a small local wrapper around Iconsax defaults.
Install into your agents
npx @its-thepoe/skills@latest install iconsaxOr install all skills.
Icon name resolver
Run this from inside a project that has iconsax-react installed:
node ~/.agents/skills/iconsax/scripts/find-iconsax-icons.mjs search
node ~/.agents/skills/iconsax/scripts/find-iconsax-icons.mjs user add
node ~/.agents/skills/iconsax/scripts/find-iconsax-icons.mjs arrow rightPrint import-ready output:
node ~/.agents/skills/iconsax/scripts/find-iconsax-icons.mjs search --importPrint JSX-ready output:
node ~/.agents/skills/iconsax/scripts/find-iconsax-icons.mjs search --jsxAdd --all if you want every match instead of the single best match.
For React Native:
node ~/.agents/skills/iconsax/scripts/find-iconsax-icons.mjs --package iconsax-react-nativejs searchContents
SKILL.md— workflow, import patterns, accessibility rules, common fixesscripts/find-iconsax-icons.mjs— searches exact icon exports from the installed Iconsax package
Docs
License
MIT
