К основному содержанию
скилл CX Codex

icon-design · oakoss — скилл для Claude Code: что делает и как установить

Скилл icon-design помогает выбрать подходящие по смыслу иконки из Lucide, Heroicons или Phosphor и настроить чистый импорт без поломки tree-shaking.

MIT 187 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill icon-design -a claude-code
Открыть на GitHub

Что делает icon-design

Скилл формализует подбор графики для интерфейсов: сопоставляет понятия с именами компонентов в трёх библиотеках (Lucide, Heroicons и Phosphor), подсказывает шаблоны для React и запрещает ставить эмодзи вместо векторных элементов.

Внутри заложены правила оформления: единый стиль контура или заливки в секции, наследование цвета через currentColor, семантические токены вроде text-primary вместо жёстких оттенков, а также размеры от w-4 h-4 для инлайна до w-10 h-10 в hero-блоках. Для кнопок без текста скилл требует указывать aria-label.

Импорт через звёздочку import * as Icons ломает tree-shaking, поэтому скилл настаивает на точечных именованных импортах и статических картах иконок. Основной библиотекой по умолчанию считается Lucide с пакетом lucide-react.

Какие задачи решает

  • подобрать иконки под смысловые категории интерфейса
  • исключить эмодзи из продакшен-компонентов
  • сохранить tree-shaking через именованные импорты
  • проверить атрибуты доступности aria-label и aria-hidden

Примеры запросов агенту

  • Подбери иконки из Lucide для сетки услуг компании
  • Переведи старые иконки с Font Awesome на Lucide в карточке товара
  • Проверь импорты в компоненте навигации и настрой tree-shaking

Как установить icon-design

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill icon-design -a claude-code

2Вручную: положить файлы

~/.claude/skills/icon-design/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/icon-design/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об icon-design

Как установить icon-design в Claude Code?

Выполните команду npx skills add oakoss/agent-skills --skill icon-design -a claude-code. Конфигурация сохранится по пути ~/.claude/skills/icon-design/SKILL.md.

Что делает скилл icon-design?

Он задаёт правила выбора библиотек и компонентов иконок, предотвращает смешивание стилей и помогает внедрять правильные шаблоны разметки с Tailwind.

Какую библиотеку иконок скилл рекомендует использовать по умолчанию?

В качестве базового решения рекомендуется Lucide благодаря поддержке более 1600 иконок, интеграции с React и динамической загрузке через lucide-react/dynamic.

Исходный текст

SKILL.md · MIT
---
name: icon-design
description: |
  Select semantically appropriate icons for websites using Lucide, Heroicons, or Phosphor. Covers concept-to-icon mapping, React/HTML templates, and tree-shaking patterns.

  Use when: building feature sections, service grids, contact info, navigation, or any UI needing icons. Prevents emoji usage, ensures consistency.
license: MIT
metadata:
  author: oakoss
  version: '1.1'
---

# Icon Design

Select the right icon for the job. Maps concepts to icons across three modern libraries, provides ready-to-use templates, and prevents common mistakes like broken tree-shaking and inconsistent styles.

## Quick Reference

| Concept        | Lucide          | Heroicons                | Phosphor          |
| -------------- | --------------- | ------------------------ | ----------------- |
| Award/Quality  | `Trophy`        | `trophy`                 | `Trophy`          |
| Price/Value    | `Tag`           | `tag`                    | `Tag`             |
| Location       | `MapPin`        | `map-pin`                | `MapPin`          |
| Expertise      | `GraduationCap` | `academic-cap`           | `GraduationCap`   |
| Support        | `MessageCircle` | `chat-bubble-left-right` | `ChatCircle`      |
| Security       | `Shield`        | `shield-check`           | `Shield`          |
| Speed          | `Zap`           | `bolt`                   | `Lightning`       |
| Phone          | `Phone`         | `phone`                  | `Phone`           |
| Email          | `Mail`          | `envelope`               | `Envelope`        |
| User/Profile   | `User`          | `user`                   | `User`            |
| Team           | `Users`         | `user-group`             | `Users`           |
| Settings       | `Settings`      | `cog-6-tooth`            | `Gear`            |
| Home           | `Home`          | `home`                   | `House`           |
| Search         | `Search`        | `magnifying-glass`       | `MagnifyingGlass` |
| Check/Success  | `Check`         | `check`                  | `Check`           |
| Close/Cancel   | `X`             | `x-mark`                 | `X`               |
| Menu           | `Menu`          | `bars-3`                 | `List`            |
| Calendar       | `Calendar`      | `calendar`               | `Calendar`        |
| Clock/Time     | `Clock`         | `clock`                  | `Clock`           |
| Heart/Favorite | `Heart`         | `heart`                  | `Heart`           |

## Library Selection

| Library       | Best For                         | Package                 |
| ------------- | -------------------------------- | ----------------------- |
| **Lucide**    | General use, React projects      | `lucide-react`          |
| **Heroicons** | Tailwind projects, minimal style | `@heroicons/react`      |
| **Phosphor**  | Weight variations needed         | `@phosphor-icons/react` |

Default recommendation: Lucide (1,600+ icons, excellent React integration, dynamic loading via `lucide-react/dynamic`).

## Selection Process

1. **Identify the concept** -- what does the label/title communicate?
2. **Check semantic mapping** -- see `references/semantic-mapping.md`
3. **Choose library** -- Lucide (default), Heroicons (Tailwind), Phosphor (weights)
4. **Apply template** -- see `references/icon-templates.md`
5. **Verify consistency** -- same style, same size within each section

## Icon Style Rules

| Rule              | Detail                                                                |
| ----------------- | --------------------------------------------------------------------- |
| No mixed styles   | Use all outline OR all solid in a section                             |
| No emoji          | Use proper icon components (tree-shakeable)                           |
| Use currentColor  | Icons inherit text color via `stroke="currentColor"`                  |
| Semantic colors   | Use `text-primary`, not `text-blue-500`                               |
| Consistent sizing | Inline `w-4 h-4`, cards `w-8 h-8`, hero `w-10 h-10`                   |
| Tree-shaking safe | Use explicit named imports and icon maps, never `import *`            |
| Accessibility     | Add `aria-hidden="true"` to decorative icons, `aria-label` to buttons |

## Common Mistakes

| Mistake                                                            | Correct Pattern                                                                  |
| ------------------------------------------------------------------ | -------------------------------------------------------------------------------- |
| Importing all icons with `import * as Icons` breaking tree-shaking | Use explicit named imports and a static icon map                                 |
| Mixing outline and solid icon styles within the same section       | Pick one style per section and apply consistently                                |
| Using emoji instead of proper icon components                      | Always use tree-shakeable icon components from Lucide, Heroicons, or Phosphor    |
| Hardcoding color values like `text-blue-500` on icons              | Use semantic colors like `text-primary` so icons inherit theme changes           |
| Choosing icons by visual appeal rather than semantic meaning       | Map the concept first using the semantic mapping reference, then select the icon |
| Missing `aria-label` on icon-only buttons                          | Add `aria-label="Description"` to buttons containing only icons                  |
| Using old Heroicons import paths without size prefix               | Use `@heroicons/react/24/outline` with the size prefix                           |

## Delegation

- **Audit existing icon usage for consistency and tree-shaking issues**: Use `Explore` agent to scan imports and identify mixed styles or wildcard imports
- **Migrate icons from Font Awesome or Material to modern libraries**: Use `Task` agent with the migration guide reference
- **Plan icon system architecture for a design system**: Use `Plan` agent to select library, define sizing conventions, and establish semantic mappings

## References

- [semantic-mapping.md](references/semantic-mapping.md) -- Full concept-to-icon tables by category (quality, price, location, trade-specific, navigation, status)
- [icon-templates.md](references/icon-templates.md) -- React/HTML patterns with Tailwind (feature cards, buttons, inputs, navigation, status badges)
- [library-comparison.md](references/library-comparison.md) -- Lucide vs Heroicons vs Phosphor (features, bundle size, import patterns)
- [migration-guide.md](references/migration-guide.md) -- Font Awesome, Material Icons, Feather, and emoji to modern equivalents
- [accessibility.md](references/accessibility.md) -- Decorative vs meaningful icons, aria attributes, screen reader patterns

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — icon-design от других авторов.

icon-design omer-metin Скилл icon-design для проектирования иконок, которые понятны с первого взгляда. Знает про оптическое выравнивание, единство стиля в наборе и масштабирование символов. CX Codex +1 124установок add-icon FortAwesome Скилл add-icon подбирает и вставляет иконки Font Awesome в проект с учётом установленного фреймворка и способа подключения. CX Codex +1 784установок suggest-lucide-icons nweii Скилл suggest-lucide-icons подбирает иконки из набора Lucide под понятие, место в интерфейсе или заметку. Проверяет имена по каталогу, чтобы не выдумать несуществующую иконку. CX Codex +1 653установок IconVaultKit ali-ahemad429 MCP-сервер IconVaultKit ищет иконки в 100+ открытых библиотеках и отдаёт готовую SVG-разметку по id вида mdi:home. CX Codex +1 269установок icon-system Owl-Listener Скилл icon-system задаёт правила для системы иконок: сетку 24x24px, шкалу размеров, именование и доступность. Пригодится при наведении порядка в дизайн-системе проекта. CX Codex +1 2 800установок icon-set-generator jezweb Скилл icon-set-generator для Claude Code генерирует для проекта набор SVG-иконок в едином стиле, на общей сетке и с одинаковым штрихом. CX Codex +1 2 000установок svg-icon-generator Jeremy Longshore Скилл svg-icon-generator для задач с SVG-иконками: подсказывает шаги, пишет код и проверяет результат. Включается сам, когда в запросе есть «svg». CX Codex +1 1 400установок

Из того же набора106

Весь набор →
ci-cd-architecture Скилл ci-cd-architecture помогает спроектировать CI/CD-пайплайн, выбрать платформу деплоя и настроить безопасность GitHub Actions. Пригодится при запуске и развитии проекта. CX Codex +1 199установок openapi Настраивает агента на проектирование спецификаций OpenAPI 3.1 и генерацию TypeScript-клиентов. Помогает писать схемы контрактов и документацию для REST API. CX Codex +1 197установок css-animation-patterns Скилл css-animation-patterns для Claude Code помогает создавать CSS-анимации без перерисовки макета. Описывает аппаратно ускоренные свойства, переходы и новые API движения. CX Codex +1 196установок pnpm-workspace Скилл pnpm-workspace настраивает монорепозитории на базе pnpm и каталоги версий. Помогает агенту связывать локальные пакеты через протокол workspace:. CX Codex +1 195установок pdf-tools Скилл pdf-tools для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI, который покрывает весь цикл работы с PDF: извлечение текста и таблиц, генерацию, изменение и заполнение форм. CX Codex +1 186установок ssh-remote Скилл ssh-remote помогает ассистенту настраивать SSH-подключения, генерировать ключи Ed25519, пробрасывать порты и безопасно передавать файлы. CX Codex +1 183установок tanstack-hotkeys Скилл для агента: подсказывает, как собрать горячие клавиши в React на TanStack Hotkeys — от одиночных комбинаций до записи пользовательских шорткатов. CX Codex +1 179установок technical-docs Скилл technical-docs для Claude Code помогает писать и обновлять техническую документацию, строить диаграммы Mermaid и сверять документацию с кодом. Помогает вести doc-as-code и проверять покрытие. CX Codex +1 177установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой