skills/icon-designer/SKILL.md
Create cohesive icon sets and design systems
npx skillsauth add jmsktm/claude-settings Icon DesignerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
An icon design expert that creates cohesive, scalable icon sets for interfaces and brands. This skill combines visual design principles, icon design best practices, and SVG optimization to produce crisp, consistent iconography that enhances user interfaces.
Whether you need a complete icon system for a product, custom icons for a specific feature, or guidance on icon selection and usage, this skill ensures your icons are both beautiful and functional.
| Action | Command/Trigger | |--------|-----------------| | Create custom icons | "Design icons for [feature/category]" | | Choose icon library | "Recommend icon library for [project]" | | Define icon system | "Create icon design system" | | Optimize icons | "Audit my icons for consistency" | | Generate SVG code | "Create SVG for [icon description]" | | Icon naming | "Help name my icon set" |
Clarity First
Consistency
Simplicity
Alignment
Scalability
Accessibility
Style: Line-based, hollow
Stroke: 1.5-2px
Best for: Modern UI, minimal aesthetics
Examples: Heroicons, Feather, Lucide
When to use: Clean interfaces, lots of icons
Style: Solid shapes
Stroke: None or minimal
Best for: Strong visual presence, clear states
Examples: Material Filled, Bootstrap
When to use: Primary actions, selected states
Style: Two-color, layered
Stroke: Varies
Best for: Sophisticated, depth
Examples: Phosphor Duotone
When to use: Premium products, editorial
Style: Organic, imperfect
Stroke: Variable, playful
Best for: Friendly, approachable brands
Examples: Streamline Loopy
When to use: Creative, casual, fun products
16px (1rem)
24px (1.5rem)
32px (2rem)
48px+ (3rem+)
SVG Best Practices
<svg
xmlns="http://www.w3.org/2000/svg"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="2"
stroke-linecap="round"
stroke-linejoin="round"
aria-hidden="true"
>
<path d="M..." />
</svg>
Key Attributes
viewBox: Defines coordinate system (usually "0 0 24 24")currentColor: Inherits text coloraria-hidden: Decorative, screenreader skipsrole="img" + aria-label: When icon has semantic meaningOptimization
Structure: [object]-[variant]-[state]
Examples:
arrow-right (directional)user-circle (object + container)heart-filled (state variant)trash-outline (style variant)chevron-down-small (size variant)Categories:
edit, delete, save, sendhome, menu, back, forwarduser, file, folder, imagecheck, error, warning, infoarrow-up, chevron-rightgithub, twitter, linkedinICON SET SPECIFICATION
Project: [Name]
Style: [Outlined/Filled/Duo-tone]
DESIGN SYSTEM
Grid: 24x24px
Stroke width: 2px
Corner radius: 2px (rounded style)
Padding: 2px safe area on all sides
Alignment: Pixel grid
Color: currentColor (inherits from parent)
ICON LIST
✓ home - Home navigation
✓ user - User profile
✓ settings - Settings/preferences
✓ search - Search function
✓ plus - Add/create action
✓ trash - Delete action
✓ edit - Edit action
✓ chevron-down - Dropdown indicator
✓ check - Success/confirmation
✓ x - Close/dismiss
[30 more icons...]
DESIGN PRINCIPLES
- Simple geometric shapes
- 2px stroke throughout
- Rounded caps and joins
- Optical centering (not mathematical)
- All icons tested at 16px and 24px
- Work in monochrome
USAGE GUIDELINES
- Use outlined version for default state
- Use filled version for active/selected state
- Minimum size: 16px (1rem)
- Always include aria-label or surrounding text
- Use currentColor for theming
- 24px size for most UI (buttons, navigation)
- 16px for inline text icons
SVG EXAMPLES
[Code for 5-10 representative icons]
INTEGRATION
React:
import { Icon } from '@/components/Icon'
<Icon name="home" size={24} />
HTML:
<svg class="icon">...</svg>
CSS:
.icon { width: 1.5rem; height: 1.5rem; stroke: currentColor; }
FIGMA/DESIGN FILES
[Link to design source files]
Free & Open Source
| Library | Style | Count | License | Best For | |---------|-------|-------|---------|----------| | Heroicons | Outlined/Filled | 300+ | MIT | Tailwind projects, modern UI | | Lucide | Outlined | 1000+ | ISC | Beautiful, customizable | | Phosphor | 6 weights | 6000+ | MIT | Versatile, professional | | Tabler Icons | Outlined | 4000+ | MIT | Comprehensive, pixel-perfect | | Bootstrap Icons | Filled/Outlined | 1800+ | MIT | Bootstrap projects | | Feather | Outlined | 280+ | MIT | Simple, elegant (unmaintained) | | Iconoir | Outlined | 1300+ | MIT | Lightweight, modern | | Material Symbols | Variable | 2500+ | Apache | Google ecosystem |
Premium
| Library | Style | Price | Best For | |---------|-------|-------|----------| | Nucleo | Multi-style | $99-179 | Comprehensive, professional | | Streamline | Multi-style | $149+ | Detailed, illustrated | | Iconic | Multi-style | Free/Pro | High quality, curated |
SaaS Product: Heroicons or Lucide (modern, clean) E-commerce: Phosphor or Bootstrap Icons (comprehensive) Mobile App: Material Symbols (familiar, extensive) Creative/Agency: Custom set or Streamline (unique) Dashboard: Tabler Icons (technical, clear) Marketing Site: Phosphor Duotone (sophisticated)
data-ai
Optimize YouTube videos for SEO, thumbnails, descriptions, and audience retention
testing
Design and facilitate effective workshops with agendas, activities, and outcomes
data-ai
Design and optimize AI-powered workflows for complex tasks
data-ai
Design and implement automated workflows to eliminate repetitive tasks and streamline processes