# fa-help

Answers Font Awesome questions from the official documentation instead of model memory. Handy for setup, styling and upgrade work.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 498 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/fa-help/SKILL.md
- Updated: 2026-07-02
- HTML: https://affpapa.org/en/nevibecode/skills/fa-help

## What it does

The skill takes one required argument: a question about Font Awesome — setup, styling, animation, APIs, upgrading, troubleshooting. The agent pulls the index at `https://docs.fontawesome.com/llms.txt`, picks the matching page and reads it with `WebFetch`. Answers come from that text, so version details and code samples reflect the docs rather than stale training data.

A single question costs at most three page fetches. The narrowest page goes first; a second one follows only when context is missing. Each answer ends with a link to the source, with the `.md` extension stripped from the URL. When a `.font-awesome.md` file sits in the project, examples get tailored to your integration method, version and license.

Raw `<svg>` markup is out of scope here. Ask for it and the skill points you to `/add-icon`, which pulls authoritative markup from the Font Awesome API. Questions about plain CSS, JavaScript or unrelated frameworks get a short answer with no doc fetch. If the documentation does not cover something, the skill says so instead of inventing a reply.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add FortAwesome/fontawesome-agent-tools --skill fa-help -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/fa-help/SKILL.md

## When to use it
- check how to load Font Awesome through a Kit
- debug an icon that renders blank
- find the doc page for your version
- pick an animation approach for an icon
- get a code sample matching your setup

## Example prompts
- How do I set up Font Awesome with a Kit in this project?
- Why does my icon render blank after the upgrade?
- How do I turn on the spin animation for an icon?

## Similar
- [better-icons](https://affpapa.org/en/nevibecode/skills/better-icons.md) — skill · 5900 installs
- [make-interfaces-feel-better](https://affpapa.org/en/nevibecode/skills/make-interfaces-feel-better.md) — skill · 73400 installs
- [icon-set-generator](https://affpapa.org/en/nevibecode/skills/icon-set-generator.md) — skill · 1900 installs
- [imagery](https://affpapa.org/en/nevibecode/skills/imagery.md) — skill · 533 installs
- [morphing-icons](https://affpapa.org/en/nevibecode/skills/morphing-icons.md) — skill · 362 installs
- [Help Scout MCP Server](https://affpapa.org/en/nevibecode/mcp/help-scout-mcp-server.md) — MCP server · ★ 45

From the same set: [fortawesome/fontawesome-agent-tools](https://affpapa.org/en/nevibecode/by/fortawesome/fontawesome-agent-tools.md) — 2 cards

---
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