Font Awesome

Setup

On first use, read setup.md silently and start naturally. Never mention setup files to the user.

When to Use

User needs icons in a web project. Agent handles icon selection, installation method, and framework-specific syntax.

Architecture

No persistent storage needed. Icon preferences tracked in user's main memory if requested.

Quick Reference

Core Rules

1. Determine Installation Method First

Ask or infer the project setup before suggesting icons:

2. Use Correct Syntax Per Method

CDN Kit (easiest):

\x3Cscript src="https://kit.fontawesome.com/YOUR_KIT_ID.js" crossorigin="anonymous">\x3C/script>
\x3Ci class="fa-solid fa-house">\x3C/i>

npm (fontawesome-free):

npm install @fortawesome/fontawesome-free

import '@fortawesome/fontawesome-free/css/all.min.css';

\x3Ci class="fa-solid fa-user">\x3C/i>

React:

npm install @fortawesome/react-fontawesome @fortawesome/fontawesome-svg-core @fortawesome/free-solid-svg-icons

import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';
import { faHouse } from '@fortawesome/free-solid-svg-icons';

\x3CFontAwesomeIcon icon={faHouse} />

3. Know the Icon Styles

4. Icon Search Strategy

When user asks for an icon:

1. Suggest semantic name first (e.g., fa-envelope for email)
2. Provide 2-3 alternatives if ambiguous
3. Specify style availability (free vs pro)

Common mappings:

5. Sizing and Styling

Size classes:

\x3Ci class="fa-solid fa-house fa-xs">\x3C/i>   \x3C!-- 0.75em -->
\x3Ci class="fa-solid fa-house fa-sm">\x3C/i>   \x3C!-- 0.875em -->
\x3Ci class="fa-solid fa-house fa-lg">\x3C/i>   \x3C!-- 1.25em -->
\x3Ci class="fa-solid fa-house fa-xl">\x3C/i>   \x3C!-- 1.5em -->
\x3Ci class="fa-solid fa-house fa-2xl">\x3C/i>  \x3C!-- 2em -->

Fixed width (for alignment in lists):

\x3Ci class="fa-solid fa-house fa-fw">\x3C/i>

Animation:

\x3Ci class="fa-solid fa-spinner fa-spin">\x3C/i>
\x3Ci class="fa-solid fa-heart fa-beat">\x3C/i>
\x3Ci class="fa-solid fa-bell fa-shake">\x3C/i>

Rotation:

\x3Ci class="fa-solid fa-arrow-right fa-rotate-90">\x3C/i>
\x3Ci class="fa-solid fa-arrow-right fa-rotate-180">\x3C/i>
\x3Ci class="fa-solid fa-arrow-right fa-flip-horizontal">\x3C/i>

6. Accessibility

Always provide accessible labels:

\x3C!-- Decorative (hidden from screen readers) -->
\x3Ci class="fa-solid fa-house" aria-hidden="true">\x3C/i>

\x3C!-- Meaningful (needs label) -->
\x3Ci class="fa-solid fa-trash" aria-label="Delete item">\x3C/i>

\x3C!-- With visible text (icon is decorative) -->
\x3Cbutton>
  \x3Ci class="fa-solid fa-save" aria-hidden="true">\x3C/i>
  Save
\x3C/button>

7. Version Differences

v6 (current):

• Use fa-solid, fa-regular, fa-brands
• Icon names like fa-house, fa-magnifying-glass

v5 (legacy):

• Use fas, far, fab
• Some icon names changed (e.g., fa-home → fa-house)

If working with existing v5 code, don't force upgrade unless asked.

Common Traps

• Using Pro icons in free tier → icons don't render, no error
• Wrong prefix (fa-solid vs fas) → depends on version, check project
• Missing CSS import with npm → icons show as squares
• Using v5 names in v6 → some work, some don't (e.g., fa-home deprecated)
• Not setting aria-hidden on decorative icons → screen reader noise

External Endpoints

No user data is sent. Icons loaded from public CDN.

Security & Privacy

Data that leaves your machine:

• HTTP request to Font Awesome CDN (if using CDN method)

Data that stays local:

• All icon choices and code

This skill does NOT:

• Track icon usage
• Send analytics
• Require authentication for free tier

Related Skills

Install with clawhub install \x3Cslug> if user confirms:

• react — React development patterns
• html — HTML best practices
• css — CSS styling patterns

Feedback

• If useful: clawhub star font-awesome
• Stay updated: clawhub sync