pimenov.ai

База знаний

Impeccable — открытый дизайн-скилл, который учит AI-инструменты понимать дизайн

Open-source агент-скилл от Пола Бакауса. Версия 3.5: harness-specific правила, Live Mode (Beta) с правкой страницы и текста в браузере, детектор из 41 правила без jsdom, команда /impeccable init. 23 команды, 7 справочников, PRODUCT.md и DESIGN.md как общая память. Работает в Cursor, Claude Code, Codex, Gemini CLI и др.

Опубликовано

Open-source агент-скилл от Пола Бакауса — создателя jQuery UI и экс-инженера Google. Учит ваш AI-кодинг-инструмент (Claude Code, Cursor, Codex CLI, Gemini CLI и десяток других) реально понимать дизайн: даёт ему 7 справочных файлов по типографике, цвету, движению и пространству и 23 команды, чтобы рулить результатом точечно. 25 000+ звёзд на GitHub, Apache 2.0, актуальная версия 3.5.0 (май 2026).

📌
Суть: AI-модели натренированы на одних и тех же SaaS-шаблонах и без подсказок выдают одинаковый «AI-slop»: Inter, фиолетовый градиент, карточки в карточках, серый текст на цветном фоне, скруглённый icon-tile над каждым заголовком. Impeccable — словарь и набор правил, которые ломают этот рефлекс и выводят результат в продакшен-качество.

Что это такое

Impeccable (по‑русски «Безупречный») — это AI-скилл (agent skill), который вы устанавливаете в свой AI-кодинг-инструмент. После установки в чате появляется команда /impeccable с 23 субкомандами. Каждая отвечает за конкретную дисциплину: типографику, цвет, движение, разметку, копирайт, анти-паттерны, аудит, полировку, итерацию в браузере.

В основе — расширение оригинального frontend-design от Anthropic, переписанное автором на собственном eval-фреймворке: тот же бриф прогонялся через frontier-модели с скиллом и без, замерялась степень «коллапса в монокультуру». Главная находка — anti-attractor процедура, которая заставляет модель сначала перечислить и отбросить свои дефолтные рефлексы, и только потом выбирать.

Репозиторий: github.com/pbakaus/impeccable. Сайт с документацией и кейсами: impeccable.style.


Что нового в версии 3.5

🆕
Версия 3.5.0 (28–29 мая 2026) — самое крупное обновление с момента запуска. Главные изменения собраны ниже, детали разнесены по соответствующим разделам.
  • Правила компилируются под конкретный инструмент. При сборке скилл вшивает harness-specific правила: Codex и GPT-5.5 получают инструкции против ровно тех дефектов, что выдают именно они, и других моделей эти правила не касаются. Ни один другой дизайн-скилл так не делает — все шлют один общий файл всем моделям.
  • Новый проект и существующий обрабатываются по-разному. На существующей кодовой базе скилл сначала читает ваши токены, тему и компоненты и работает внутри них: сохранить айдентику важнее, чем навязать свежий вид. На чистом листе берёт один seed-цвет из 129 вручную отобранных якорей (у каждого свой mood и стратегия композиции) и руками строит вокруг него всю палитру. Это убирает дрейф к одной и той же «безопасной» палитре.
  • Live Mode вышел из Alpha в Beta — подробности в разделе ниже.
  • /impeccable teach переименован в /impeccable init — старое имя работает как алиас.
  • Детектор переписан без jsdom и стал ~20× быстрее, правил теперь 41 (см. раздел про CLI).
  • Скилл сам следит за версией — в первой сессии дня тихо проверяет, не вышла ли новая версия, и предлагает обновиться. Отключается через IMPECCABLE_NO_UPDATE_CHECK=1.
  • Меньше AI-slop. Bias mining по ~190 примерам показал, что часть дефектов порождали собственные строки скилла, — их вырезали. Забанен бежево-кремовый фон (cream-palette, тот самый «claude beige»), который срабатывал в 74% случаев на GPT.

Что внутри

7 справочных файлов

Загружаются перед каждой командой и формируют общий контекст:

ФайлО чём
typographyType-системы, font pairing, modular scales, OpenType-фичи
color-and-contrastOKLCH, тинтованные нейтрали, dark mode, доступность контраста
spatial-designСистемы отступов, гриды, визуальная иерархия
motion-designEasing-кривые, стаггеринг, reduced motion
interaction-designФормы, focus-стейты, лоадинг-паттерны
responsive-designMobile-first, fluid design, container queries
ux-writingЛейблы кнопок, тексты ошибок, empty states

23 команды

Все вызываются через /impeccable <command> <target>. Можно «запинить» часто используемую через /impeccable pin audit — тогда /audit станет отдельным шорткатом.

Setup и контекст — 4 команды
  • /impeccable init (бывший teach, старое имя работает как алиас) — одноразовая настройка проекта одной командой. Из одного скана кодовой базы собирает аудиторию, бренд-голос, anti-references, регистр (brand vs product), пишет PRODUCT.md, предлагает DESIGN.md, настраивает Live Mode и подсказывает, с какой команды начать.
  • /impeccable document — генерирует DESIGN.md из существующего кода в формате Google Stitch (цвета, типографика, elevation, компоненты, do/don't).
  • /impeccable extract — вытягивает переиспользуемые компоненты и токены в дизайн-систему.
  • /impeccable shape — UX/UI-планирование до того, как написана хоть одна строка кода: бриф, мудборд, brand toolkit как картинки.
Создание и итерация — 4 команды
  • /impeccable craft — полный цикл shape → build с визуальной итерацией. Воспринимает мокапы как visual contract: проверяет, что в коде остались все обещанные элементы.
  • /impeccable live (Beta) — Visual Mode: Steer bar для правки всей страницы, точечная правка элемента и текста, accept — и изменение пишется обратно в исходник.
  • /impeccable critique — UX-ревью: иерархия, ясность, эмоциональный резонанс.
  • /impeccable audit — технические проверки: a11y, performance, респонсив.
Полировка и финал — 3 команды
  • /impeccable polish — финальный проход, выравнивание под дизайн-систему, готовность к шипу. Включает Information Architecture & Flow.
  • /impeccable harden — error handling, i18n, переполнение текста, edge cases.
  • /impeccable onboard — first-run флоу, empty states, активационные пути.
Выразительность — 5 команд
  • /impeccable bolder — амплифицировать «вялый» дизайн.
  • /impeccable quieter — приглушить «крикливый».
  • /impeccable distill — снять лишнее и довести до сути.
  • /impeccable delight — добавить моменты радости.
  • /impeccable overdrive — техно-экстраординарные эффекты.
Точечные дисциплины — 6 команд
  • /impeccable typeset — фоны, иерархия, размеры шрифтов.
  • /impeccable colorize — стратегический цвет.
  • /impeccable layout — разметка, отступы, визуальный ритм.
  • /impeccable animate — осмысленное движение.
  • /impeccable adapt — адаптация под устройства.
  • /impeccable optimize — performance.
Копирайт и UX — 1 команда
  • /impeccable clarify — улучшить непрозрачную UX-копию.

Если не знаете, какая команда нужна — /impeccable redo this hero section без имени тоже работает: скилл сам выбирает подход. А пустой /impeccable без аргументов теперь не показывает статичное меню, а читает проект, ваш незакоммиченный git-tree и последний critique и предлагает 2–3 самые ценные команды с обоснованием (нет DESIGN.mddocument; есть нерешённые замечания в редактируемых файлах → polish). Перед запуском всегда спрашивает, полное меню — ниже.

PRODUCT.md и DESIGN.md как общая память

Два файла в корне проекта, которые читает каждая команда перед генерацией:

  • PRODUCT.md — стратегический слой: кто аудитория, что за бренд, какой регистр (brand vs product), какие anti-references (например, «не как Vercel-лендинг»). Создаётся через /impeccable init.
  • DESIGN.md — визуальный слой в формате Google Stitch: палитра, типографика, токены, компоненты. Совместим с другими DESIGN.md-aware инструментами. Подробнее — в материале DESIGN.md как дизайн-система для AI-кодинга.

Эти файлы решают главную проблему AI-генерации — дрейф в «modern SaaS». Каждая последующая команда стартует не с чистого листа, а с явных констант продукта.

Live Mode (Beta)

Итерации прямо в браузере, в той кодовой базе, которую вы реально шипите. В 3.5 режим вышел из Alpha в Beta и работает на двух масштабах. Запускается /impeccable live.

  • Steer bar — правка всей страницы. Вводите (или надиктовываете) направление в новую панель Steer, и агент читает страницу целиком и правит её на месте, без выбора элемента и без перебора вариантов.
  • Точечная правка элемента. Кликаете по элементу, описываете правку обычными словами и принимаете вариант прямо в исходник.
  • Правка текста на месте. Меняете текст элемента прямо в браузере; по Apply субагент переписывает реальный исходник, из которого он рендерится, и чинит всё, что было к нему привязано (например, лейблы карточек, которые заодно служат ключами картинок).
  • Insert mode — добавляет совершенно новые элементы между уже существующими.

Работает на Vite, Next.js (включая монорепо), SvelteKit, Astro, Nuxt, умеет автоматически патчить strict-CSP. Восстановление переживает HMR, скрытые hero-блоки и оверлеи дев-тулзов; экспериментальный streaming poll сокращает отклик с секунд до долей секунды. Команды устойчивой сессии: live status, live resume, live complete.

CLI и Chrome-расширение

Два дополнительных инструмента, не требующих AI-harness:

  • CLI: npx impeccable detect src/ — детерминированный детектор анти-паттернов без LLM и без API-ключа. В 3.5 движок HTML/CSS переписан с нуля на htmlparser2 и настоящем резолвере CSS-каскада вместо jsdom: на корпусе из 160 файлов он стал примерно в 20× быстрее (0,34 с против 6,8 с, ~2 мс на файл). Движок без зависимостей и вшит прямо в скилл, чтобы работать инлайн. Правил теперь 41 в одном каноническом реестре, который питает CLI, расширение, critique и эвалы. Флаг --fast объявлен устаревшим: полный скан и так покрывает все правила, флаг принимается, но игнорируется. JSON-вывод для CI и pre-commit хуков; сканит локальные файлы, HTML и публичные URL через Puppeteer.
  • Chrome-расширение: иконка в тулбаре подсвечивает анти-паттерны прямо на любом сайте — на localhost, staging, production или у конкурентов. Движок тот же, что в CLI. В настройках появились тумблеры по каждому правилу: любое можно включить или выключить, они сгруппированы по AI tells и Quality и синхронизируются между браузерами.

Image-first генерация

С версии 3.0 скилл использует диффузионные модели для бренд-работ. /impeccable shape рисует toolkit как настоящие картинки (палитра, типографика, мудборд), /impeccable craft пре-рендерит хи-фай мок и ведёт код к нему. В деле — GPT Image 2, Nano Banana Pro, Imagen 4 Ultra. Самый сильный пайплайн — в Codex с GPT 5.5.


Поддерживаемые инструменты

11 AI-кодинг-сред:

  • Cursor (требует Nightly + Agent Skills в настройках),
  • Claude Code (плагин-маркетплейс или прямое копирование),
  • OpenCode,
  • Pi,
  • Gemini CLI (preview-версия + включить Skills в /settings),
  • Codex CLI (через /skills или $impeccable),
  • VS Code Copilot,
  • Kiro,
  • Trae (China и International),
  • Rovo Dev (от Atlassian),
  • Qoder.

Установка

Рекомендуемый способ — CLI-инсталлер из корня проекта:

npx impeccable skills install

Команда сама определяет вашу harness и кладёт сборку, скомпилированную именно под неё (.claude/skills/, .cursor/skills/ и т.д.), — отсюда и harness-specific правила. Универсальный npx skills add pbakaus/impeccable тоже работает, но ставит одну общую сборку для всех инструментов, а не скомпилированную под ваш.

Для Claude Code есть плагин-маркетплейс:

/plugin marketplace add pbakaus/impeccable

Дальше открывается /plugin в Claude Code. После установки — пишете /impeccable и получаете автодополнение по всем 23 командам.

Для точечной установки можно скачать ZIP под конкретный harness с impeccable.style или скопировать из репозитория dist/<harness>/. У Codex субагент-ассет-продюсер теперь лежит внутри папки agents/ самого скилла и подхватывается автоматически — отдельная копия в .codex/agents/ больше не нужна.


Сравнение с соседями

ИнструментСильная сторонаКогда выбирать
Impeccable23 команды + 7 справочников + Live Mode (Beta) + детектор из 41 правила (CLI/Chrome)Полный продакшен-цикл AI-фронтенда: от брифа до полировки
Anthropic frontend-designБазовый скилл, ~277k установок, оригинал, на котором всё начиналосьМинимальный entry-level, если хватает дефолтов и не нужны команды
Refero StylesГотовые DESIGN.md из реальных продуктовКогда нужен формальный «дизайн-вкус» как файл, а не словарь команд
PencilАгентный канвас с MCP внутри IDEКогда работа ведётся через визуальный канвас, а не через CLI-команды
huashu-designТерминал как дизайн-студия, китайский подходАльтернатива от другой школы; см. блог-разбор

Impeccable и Refero Styles — два слоя одного контура. Refero Styles даёт референс: «возьми вот этот стиль как файл». Impeccable даёт процесс: «вот словарь и команды, которыми ты этот стиль реализуешь и проверяешь». Пользоваться можно вместе.

Отдельный разбор соседей — Refero Styles и Refero.


Практические сценарии применения

1. Новый проект с нуля

Классический арк автора: init → shape → craft. Сначала /impeccable init собирает PRODUCT.md (аудитория, бренд-голос, anti-references). Потом /impeccable shape рисует мудборд и hi-fi мок как картинки. Потом /impeccable craft ведёт код к этому моку. Каждая последующая команда читает PRODUCT.md и DESIGN.md, и output не уплывает в generic SaaS.

2. Полировка чужого/легаси AI-кода

Если пришла кодовая база, написанная без скилла, и она выглядит как «AI-slop»: запустите /impeccable document, чтобы извлечь токены в DESIGN.md, потом /impeccable polish <area> по разделам. Это не редизайн, а выравнивание под систему.

3. Pre-ship gauntlet перед релизом

Автор предлагает три команды в очередь: audit → clarify → harden. Audit ловит технику (a11y, performance, респонсив), clarify чистит копии, harden закрывает edge cases (i18n, error states, переполнение текста).

4. Точечная правка «что-то не так, не могу описать»

Когда видно, что элемент кривой, но не получается сформулировать: /impeccable live, тычете в элемент, рисуете штрих, получаете три варианта.

5. Crititque без редизайна

/impeccable critique <area> — UX-ревью с разбором иерархии и ясности. Не правит ничего, только говорит что не так. Полезно перед демо и инвест-встречами.

6. CI/CD-гейт против AI-slop

Подключаете CLI: npx impeccable detect src/ --json → парсите вывод → блокируете PR с regression-патернами (Inter в новых файлах, фиолетовые градиенты, карточки в карточках). Никакого LLM в pipeline не нужно.

7. Аудит конкурентов

Chrome-расширение Impeccable работает на любом сайте. Открыли продукт конкурента — увидели подсветку anti-patterns и хороших решений. Бесплатный design research без подписок на Mobbin/Refero.

8. Pin-команды как личный набор

Если в вашем контуре полезно постоянно дёргать audit и polish/impeccable pin audit и /impeccable pin polish дают шорткаты /audit и /polish без потери единого namespace.


Anti-patterns, которые ловит Impeccable

Явный список того, что скилл считает «AI-slop» и борется с этим в каждой команде (всего 41 детерминированное правило):

  • Шрифты-дефолты: Inter, Arial, system-fonts. С v3.0.7 ловит и новую монокультуру: Fraunces, Geist, Mona Sans, Plus Jakarta Sans, Space Grotesk, Recoleta, Instrument Sans.
  • Italic-serif hero h1 (Fraunces, Recoleta, Newsreader, Playfair, Cormorant, Tiempos) как первичный заголовок — детектор v3.0.7 считает это структурным fingerprint AI-маркетинга 2025–2026.
  • Eyebrow-chips над h1 — uppercase letter-spaced лейбл прямо над hero-заголовком, особенно с pill-фоном.
  • Серый текст на цветном фоне — провал контраста.
  • Чистый чёрный или серый без подкраски — всегда нужен tint в направлении основного цвета.
  • Карточки в карточках — вложение без иерархии.
  • Bounce / elastic easing — анимации, выглядящие устаревшими.
  • Rounded-square icon tile над каждым заголовком — tell всех AI-лендингов.
  • Фиолетово-синий градиент — главный визуальный fingerprint AI-генерации.
  • Боковые табы с borders, dark glows, маленькие touch-targets, скипнутые heading-уровни, переполненный padding — и ещё ряд правил.

Новое в 3.5 — 14 правил: бежево-кремовый фон (cream-palette, тот самый «claude beige»), злоупотребление длинным тире (em-dash-overuse), маркетинговые баззворды (marketing-buzzword), нумерованные маркеры разделов (numbered-section-markers), афористичный ритм текста (aphoristic-cadence), «театральные» slop-фразы (theater-slop-phrase), гигантский h1 (oversized-h1), экстремальный отрицательный трекинг (extreme-negative-tracking), тонкая рамка с широкой тенью в стиле GPT (gpt-thin-border-wide-shadow), повторяющиеся полоски-градиенты (repeating-stripes-gradient), transform картинки на hover (image-hover-transform), битые картинки (broken-image), переполнение текста (text-overflow) и обрезанный контейнер (clipped-overflow-container). Заодно забанены all-caps eyebrow-лейблы, больше трёх шрифтов и введён жёсткий пол по контрасту.


Ограничения и грабли

⚠️
Это не дизайн-система. Impeccable — словарь и процесс, а не готовая система компонентов. Если у вас её нет, скилл поможет её собрать через /impeccable extract и /impeccable document, но за вас не сделает.
  • Live Mode теперь в Beta, но всё ещё не финал. Стабильно работает на Vite/Next/SvelteKit/Astro/Nuxt, но в экзотических конфигурациях (нестандартный CSP, тяжёлые портал-модалки, repeated identical-class siblings) бывают баги. Авторы их активно чинят, но в проекте с 6+ frameworks в монорепо может потребоваться время.
  • Image-first сильнее всего в Codex с GPT 5.5. На других harness'ах работает скромнее: где-то генерация недоступна вообще, где-то — без iterative-режима.
  • Не отменяет осмысленного дизайнера. Скилл резко поднимает потолок AI-генерации, но если в брифе нет ясности про продукт и аудиторию — даже с PRODUCT.md результат будет компетентным, но безадресным.
  • Анти-паттерны иногда срабатывают на легитимных кейсах. Editorial и magazine-сайты, которым исторически положены italic-serif heroes, тоже подсвечиваются — нужны ручные исключения.
  • Установка в Cursor требует Nightly канала и включённого Agent Skills. Не все команды захотят пересаживаться на nightly.
  • Скилл развивается быстро, ломающие изменения возможны. Версионирование стремительное (v1 в феврале 2026, v3 в апреле, v3.5.0 в конце мая). С 3.5 скилл сам предлагает обновиться в первой сессии дня; если хотите контролировать момент — отключите авто-проверку через IMPECCABLE_NO_UPDATE_CHECK=1 и запускайте npx impeccable skills update руками.
⚖️
Trade-off. Impeccable снимает большую часть боли «AI пишет код, но дизайн-как-Bootstrap». Взамен требует дисциплины: один раз сесть и заполнить PRODUCT.md, согласовать register и anti-references, договориться с командой про общий словарь команд. Без этого скилл ускорит работу, но не уберёт generic-вкус.

Чеклист «как встроить в работу»

Установить скилл: npx impeccable skills install (ставит сборку под вашу harness).
Запустить /impeccable init в новом проекте — заполнить PRODUCT.md осознанно, не пропускать anti-references.
Если есть существующий код — /impeccable document для генерации DESIGN.md.
Договориться с командой про базовый сценарий: shape → craft → polish для нового, polish/critique/audit для существующего.
Запинить 2–3 команды в шорткаты: /impeccable pin audit, /impeccable pin polish.
Установить Chrome-расширение для аудита продакшена и конкурентов, при желании настроить тумблеры по правилам.
Подключить CLI в CI: npx impeccable detect src/ --json как блокирующий гейт против regression-патернов (флаг --fast больше не нужен).
Оставить авто-проверку обновлений включённой или раз в спринт запускать npx impeccable skills update для свежих правил и команд.
При шипе — pre-ship gauntlet: audit → clarify → harden.

Ссылки


По теме

Если вы строите продукт с AI-кодингом и хотите, чтобы фронтенд выглядел как работа дизайнера, а не как дефолтный шаблон, — Impeccable сейчас самый компактный способ дать модели общий словарь и процесс. Хотите обсудить, как встроить такой контур в ваш стек, — напишите в Telegram