# suggest-icon

Picks a Font Awesome icon for a concept, situation or verb, then checks it exists in your version or Kit.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 551 installs · ★ 4
- Author: FortAwesome
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FortAwesome/fontawesome-agent-tools/tree/HEAD/plugins/icons/skills/suggest-icon/SKILL.md
- Updated: 2026-07-02
- HTML: https://affpapa.org/en/nevibecode/skills/suggest-icon

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/suggest-icon/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/suggest-icon/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/suggest-icon/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/suggest-icon/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install FortAwesome/fontawesome-agent-tools suggest-icon
```

2. **Manually: put the files in place**
- File: `.github/skills/suggest-icon/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/FortAwesome/fontawesome-agent-tools --path plugins/icons/skills/suggest-icon
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/suggest-icon/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add FortAwesome/fontawesome-agent-tools --skill suggest-icon -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/FortAwesome/fontawesome-agent-tools/tree/HEAD/plugins/icons/skills/suggest-icon/SKILL.md

## When to use it
- 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
- 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

## Similar
- [icon-set-generator](https://affpapa.org/en/nevibecode/skills/icon-set-generator.md) — skill · 1900 installs
- [svg-icon-generator](https://affpapa.org/en/nevibecode/skills/svg-icon-generator.md) — skill · 1300 installs
- [icon-system](https://affpapa.org/en/nevibecode/skills/icon-system.md) — skill · 2400 installs
- [llm-icon-finder](https://affpapa.org/en/nevibecode/skills/llm-icon-finder.md) — skill · 952 installs
- [solar-duotone-bold](https://affpapa.org/en/nevibecode/skills/solar-duotone-bold.md) — skill · 1400 installs
- [law-of-closure](https://affpapa.org/en/nevibecode/skills/law-of-closure.md) — skill · 1100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md