Impeccable не является ArtCraft и не входит в продукты или пакет ArtCraft; это независимое руководство, а официальные сведения есть на impeccable.style и github.com/pbakaus/impeccable.
Impeccable: словарь дизайна для вашего агента программирования
Impeccable — это навык дизайна и открытая утилита командной строки, которая даёт агенту программирования общий словарь для ревью, настройки и полировки интерфейсов. Проект создал Paul Bakaus, отправной точкой стал навык frontend-design от Anthropic, лицензия — Apache-2.0. Эта страница — независимое руководство, а не официальная документация.
- 24 команды: critique, polish, audit, typeset, distill и другие
- Детектор из 62 детерминированных правил, без LLM и без API-ключа
- Поддержка Claude Code, Cursor, Codex CLI, Copilot — всего 19 агентов
Официальный сайтРепозиторий GitHubДокументация
Последнее обновление: · English
Что такое Impeccable
Impeccable — это навык, который ставится в агент программирования и даёт ему дизайнерский словарь, плюс отдельный CLI. Он не открывает холст, а превращает дизайн в команды, которые агент умеет выполнять: критиковать, сжимать, настраивать шрифт, чистить, укреплять. Проект вырос из навыка frontend-design от Anthropic и публикуется под Apache-2.0.
Мишень — вкус агентов по умолчанию: Inter везде, градиенты от фиолетового к синему, карточки в карточках, серый текст на цветном фоне, скруглённая иконка над каждым заголовком. 62 детерминированных правила ловят эти признаки прямо во время правок, без LLM и без API-ключа.
Лучше всего он работает на уже существующих интерфейсах: указываете на страницу или компонент и итерируете. Новые страницы он тоже собирает, но сам проект признаёт, что этот режим сложнее. Важно: Impeccable — независимый открытый проект, а не продукт ArtCraft и не часть её пакета.
Установка и настройка
Выполните команду в корне проекта. Для npx нужен Node 18.19 или новее. Установщик определит ваши инструменты, спросит про установку в проект или глобально и предложит дизайн-хук там, где инструмент его поддерживает. Хук лучше принять.
Затем перезагрузите инструмент и запустите /impeccable init (в Codex — $impeccable init). Для скриптов есть флаги --providers=claude,codex,cursor и --scope=project|global. Существующую установку обновляет npx impeccable update.
npx impeccable install- Проверьте Node 18.19+ и перейдите в корень проекта.
- Запустите npx impeccable install, выберите область проекта или глобальную и включите дизайн-хук, если он доступен.
- Перезагрузите инструмент и выполните /impeccable init (в Codex — $impeccable init), чтобы создать PRODUCT.md.
- Чтобы зафиксировать визуальную систему, запустите /impeccable document и создайте DESIGN.md; дальше поддерживайте актуальность через npx impeccable update.
Основные команды
Всего команд 24. Вызов строится как «команда + цель», например /impeccable critique the pricing cards; в Codex вместо слэша ставится $. Если ввести только /impeccable, агент покажет список. Ниже семь самых полезных.
| Команда | Что делает | Когда применять |
|---|---|---|
/impeccable init | Читает код, спрашивает только то, что нельзя вывести, и записывает PRODUCT.md. | Один раз в начале проекта, чтобы задать контекст остальным командам. |
/impeccable critique | Проводит UX-ревью с оценкой по эвристикам юзабилити и расставляет порядок исправлений. | Перед редизайном или чтобы понять, где застревает сценарий. |
/impeccable polish | Делает финальный проход перед выпуском. | Когда функциональность зафиксирована и до релиза близко. |
/impeccable audit | Готовит технический отчёт о доступности, производительности, темах, адаптивности и целостности реализации с находками от P0 до P3. | Перед релизом или чтобы разобрать накопившийся технический долг. |
/impeccable typeset | Исправляет шрифты, иерархию, размеры и отступы. | Когда типографика выглядит рыхло или иерархия смазана. |
/impeccable distill | Убирает то, что странице не нужно. | Когда контента слишком много и фокус теряется. |
/impeccable hooks status|on|off | Показывает, включает или выключает дизайн-хук, который проверяет файлы интерфейса при правках агента. | Чтобы убедиться, что автопроверка работает, или временно её отключить. |
Рекомендуемый порядок работы
Сначала контекст, потом экран. init спрашивает только то, что нельзя вывести: для кого продукт, что он должен делать и какие есть ограничения. Ответы попадают в PRODUCT.md, и его читают все последующие команды. Если визуальная система уже есть, запустите document и зафиксируйте правила бренда в DESIGN.md, чтобы агент не менял стиль посреди работы.
Чем уже цель, тем лучше результат. Вместо «переделай всю страницу» попробуйте «сделай critique карточек тарифов». Часто используемые команды закрепляются через /impeccable pin audit и превращаются в ярлык /audit; перед публикацией идут audit, а затем polish.
- Запустите /impeccable init один раз на проект и просмотрите получившийся PRODUCT.md.
- Если есть готовая дизайн-система, выполните /impeccable document и опишите шрифты, цвета и компоненты в DESIGN.md.
- Итерируйте по секциям: /impeccable critique the pricing cards, затем bolder, quieter, distill или typeset для корректировки направления.
- Перед публикацией прогоните /impeccable audit и /impeccable polish, а любимые команды закрепите через pin.
Поддерживаемые агенты
Официальный список широк: Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness и Veto. Установка зависит от инструмента; полный перечень есть в официальной документации.
У Claude Code, Copilot и Grok есть плагины; дизайн-хук поддерживают Claude Code, Cursor, Codex, GitHub Copilot, Grok Build и Hermes Agent. В Codex нужно одобрить хук проекта в /hooks, в Grok Build выполнить /hooks-trust, а в Hermes включить плагин.
Без Node можно скопировать папку навыка вручную. Если нужен только детектор, npx impeccable detect работает без агента. Режим live поддерживает Vite, Next, SvelteKit, Astro, Nuxt и обычный HTML, но правит только локальную рабочую копию.
Impeccable и ArtCraft MCP
Названия похожи, потому что оба инструмента заставляют агента что-то производить, но уровни у них разные. Impeccable работает с исходным кодом интерфейса, а ArtCraft MCP — это официальный MCP/CLI для отдельных приложений от storytold, который управляет локальными Crafting Apps вроде PhotoCraft. Это не та же вещь, что community-API artcraft-mcp по подписке.
| Критерий | Impeccable | ArtCraft MCP |
|---|---|---|
| На что влияет | Frontend-код в репозитории: компоненты, JSX/TSX, CSS и структура страниц. | Локальные Crafting Apps (например, PhotoCraft) и их процессы работы с изображениями и видео. |
| Что даёт | Рекомендации по дизайну, правки кода, отчёты critique/audit, файлы PRODUCT.md и DESIGN.md. | Изображения или видео и автоматизированные операции внутри этих приложений. |
| Когда выбирать | Когда нужно собрать, оценить или отполировать интерфейс. | Когда нужно массово создавать или обрабатывать изображения и видео и автоматизировать работу приложений. |
| Можно ли совмещать | Да: интерфейс — на Impeccable, производство материалов — на ArtCraft MCP. | Да, но только для медиафайлов: он не делает дизайн-ревью интерфейса и не заменяет Impeccable. |
Руководство по ArtCraft MCPCrafting Apps
Границы и безопасность
Impeccable — это навык фронтенд-дизайна и CLI, а не приложение для дизайна и не генератор изображений. Режим live правит только локальную рабочую копию; не внедряйте его в развёрнутый сайт и не ослабляйте production-CSP ради его работы.
Хуки выполняются вне одобрения модели. В Claude Code установленный командный хук может сработать даже при отказе от команд модели, а первая правка способна скачать движок. Проверяйте хуки перед запуском без присмотра или отключайте их через --settings '{"disableAllHooks": true}'.
Телеметрия анонимно записывает, какие визуальные направления показали и какое выбрали; имя проекта, файлы, код и PRODUCT.md не отправляются. Отключается через npx impeccable telemetry off, DO_NOT_TRACK=1 или "telemetry": false в .impeccable/config.json. У детектора код выхода 2 означает находки, 1 — что цель не удалось просканировать.
Связанные руководства
Частые вопросы
Что такое Impeccable и является ли он продуктом ArtCraft?
Impeccable — навык дизайна и CLI для агентов программирования, созданный Paul Bakaus: 24 команды и детектор из 62 правил под лицензией Apache-2.0. Это не продукт ArtCraft и не часть её пакета. Страница представляет собой независимое руководство; официальные источники — impeccable.style и github.com/pbakaus/impeccable.
Как установить?
В корне проекта выполните npx impeccable install и перезагрузите инструмент. Затем запустите /impeccable init, а в Codex — $impeccable init, чтобы создать PRODUCT.md. Для npx нужен Node 18.19 или новее; обновляет установку npx impeccable update, полные шаги есть на impeccable.style/docs.
Чем critique отличается от audit?
critique — это UX-ревью с оценкой по эвристикам юзабилити, которое подсказывает, что исправлять первым. audit — технический отчёт о доступности, производительности, темах, адаптивности и целостности реализации с находками от P0 до P3. Первый оценивает опыт, второй проверяет инженерию, и обычно их применяют подряд.
Нужен ли API-ключ?
Детектору — нет: все 62 правила детерминированы и не вызывают LLM и не читают ключи. Сам навык работает внутри агента, поэтому отдельный ключ модели тоже не нужен. Телеметрию можно отключить через npx impeccable telemetry off или DO_NOT_TRACK=1.
С какими агентами он работает?
С Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness и Veto. Установка и поддержка хуков зависят от инструмента; актуальный список — на impeccable.style/docs.
Что выбрать: Impeccable или ArtCraft MCP?
Зависит от того, что вы меняете. Impeccable работает с кодом интерфейса и возвращает рекомендации, правки и ревью. ArtCraft MCP управляет локальными приложениями вроде PhotoCraft, создаёт изображения и видео и автоматизирует их обработку. Их можно сочетать, но ArtCraft MCP не является инструментом дизайн-ревью и не заменяет Impeccable.
Уведомление о независимости
Impeccable — независимый открытый проект, который создал Paul Bakaus. Он не связан с ArtCraft, не является продуктом ArtCraft и не входит в её пакет или официальные компоненты. Эту страницу написал третья сторона для русскоязычных читателей; по командам, требованиям и новинкам ориентируйтесь на официальный сайт impeccable.style и репозиторий github.com/pbakaus/impeccable. ArtCraft MCP — другая официальная интеграция, ориентированная на Crafting Apps, и решает иную задачу.
Sources
Every fact on this page comes from the pages below, checked on 3 November 2026.