suggest-icon — Claude Code skill: pick Font Awesome icons
Picks a Font Awesome icon for a concept, situation or verb, then checks it exists in your version or Kit.
npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a claude-codeWhat suggest-icon does
The skill takes one required argument: the concept, situation, noun or verb that needs an icon. It does not trust the model's memory for the answer. It resolves the Font Awesome version first, verifies the guessed icon exists, and searches for alternatives with fa search or the scripts under plugins/icons/skills/suggest-icon/.
When the project root has a .font-awesome.md file with a Kit ID, the search is scoped to that Kit's subset. That matters, because a Kit holds only part of the icon set and recommending an icon outside it gives you a broken result. Membership is confirmed with fa kit icon, and scoped search runs through fa search --kit-token <TOKEN>. The fa kit commands need auth (fa whoami or FA_API_TOKEN) and fa version 0.8.0 or newer.
Without fa on PATH the skill falls back to Python scripts and warns that suggestions can't be scoped to the Kit. Results come back as a table: icon name, families, license availability. Raw SVG markup is off the table — the skill points you to /add-icon instead.
What it helps with
- find an icon for a concept or action
- confirm an icon exists in a given Font Awesome version
- scope icon picks to a configured Kit
- surface alternatives when the first guess misses
- check whether an icon is free or needs a subscription
Example prompts for the agent
- Suggest an icon for the file upload section
- I need an icon for "subscription" — check it against our version
- Find an icon for a delete button and add it to the component
How to install suggest-icon
1Skills CLI (Vercel)
npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a claude-code2Manually: put the files in place
~/.claude/skills/suggest-icon/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/suggest-icon/
1Skills CLI (Vercel)
npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a codex2Manually: put the files in place
.agents/skills/suggest-icon/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a cursor2Manually: put the files in place
.cursor/skills/suggest-icon/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install FortAwesome/fontawesome-agent-tools suggest-icon2Manually: put the files in place
.github/skills/suggest-icon/SKILL.md1Skills CLI (Vercel)
npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a gemini-cli2Platform CLI
gemini skills install https://github.com/FortAwesome/fontawesome-agent-tools --path plugins/icons/skills/suggest-iconManually: put the files in place
.devin/skills/suggest-icon/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about suggest-icon
How do I install suggest-icon in Claude?
Run npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a claude-code. The skill lands at ~/.claude/skills/suggest-icon/SKILL.md.
What does suggest-icon do?
It suggests a Font Awesome icon for a given concept or situation, verifies it against the chosen version, and searches for alternatives. With a Kit configured, suggestions stay inside that Kit.
What do I need for Kit-aware suggestions?
The fa CLI at version 0.8.0 or newer plus auth via fa whoami or FA_API_TOKEN. Without fa the skill still runs on Python scripts, but it can't scope picks to the Kit.
