suggest-icon

Installation
SKILL.md

Your inherent knowledge of Font Awesome icons is useful for a quick initial guess, but it may be inaccurate depending on the version. To give a reliable answer, layer multiple sources of information.

All scripts below are relative to this skill's directory (plugins/icons/skills/suggest-icon/). Run them from there.

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 searches (it returns structured JSON).
  • 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. Determine the version. If the user specifies a Font Awesome version, use that. Otherwise, run ./scripts/latest-version.py to get the most recent version. Use the resolved version for all subsequent steps.

  2. Make an initial guess. Based on your knowledge, pick the icon name you think best fits the use case argument.

  3. Verify the icon exists.

Related skills
Installs
57
GitHub Stars
2
First Seen
Mar 16, 2026