suggest-icon（建议图标）

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.

- fa CLI: Run fa icons --version <version> --name <your-guess>. The icon exists if data.release.icon is non-null. The familyStylesByLicense field shows the free/pro breakdown. - Fallback: Run ./scripts/icon-exists.py --version <version> --icon-name <your-guess>. Exit code 0 means the icon exists; exit code 1 means it does not.

1. Search for alternatives. Do this regardless of whether your initial guess exists — searching often surfaces more specific or better-fitting icons that you wouldn't think of on your own.

- fa CLI: Run fa search --version <version> --query <your-guess> --page-size 10. Results are at data.searchPaginated.icons[], each with id, label, unicode, and familyStylesByLicense. - Fallback: Run ./scripts/search.py --version <version> --query <your-guess> to find related icons from the Font Awesome GraphQL API.

1. Present the recommendation. Pick the best match as your primary recommendation, and include relevant alternatives if the search turned up other good options. Use a markdown table like this example: Icon Families Availability mug-saucer classic, sharp, duotone, sharp-duotone Free If the icon is pro-only, note that a Font Awesome subscription is required: Icon Families Availability album-collection classic, sharp, duotone, sharp-duotone Pro (requires a subscription)
2. Never provide bare SVG markup. If the user asks for raw <svg> output of an icon, do not generate it from your own knowledge. Instead, direct them to use /add-icon which can fetch authoritative SVG markup from the Font Awesome API via fa icons --svg-format.
3. Offer to add the icon. After presenting your recommendation, ask the user: "Would you like me to add this icon to your code?" If they say yes or provide a location, invoke /add-icon with the recommended icon name (and location if given).