add-icon

Add a Font Awesome icon to the user's project. This skill handles icon name resolution, project detection, and code generation for every Font Awesome integration method.

Scripts referenced from suggest-icon are relative to plugins/icons/skills/suggest-icon/. Scripts referenced from add-icon are relative to plugins/icons/skills/add-icon/. Run them from their respective directories.

Tool selection

At the start, run command -v fa to check whether the fa CLI is available on PATH.

• If fa is found: use it for icon lookups and kit fetching (it returns structured JSON). For kit operations (fa kits), check auth first: run fa whoami to see if the user is logged in. If logged in, fa kits will work directly. If not logged in but FA_API_TOKEN is set, fa kits will also work. If neither, tell the user: "You need to be logged in to the Font Awesome CLI for kit operations. Run fa login in a separate terminal, then come back here and try again." If they cannot log in, fall back to fetch-kit.py.
• If fa is not found: fall back to the Python scripts described below.
• latest-version.py is always used for version detection — the fa CLI has no equivalent.

Steps

1. Resolve the icon name

First, determine the Font Awesome version. If the user specifies one, use that. Otherwise run ./scripts/latest-version.py (in the suggest-icon skill directory) to get the latest.

Then verify the icon exists: