База знаний

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

Open-source агент-скилл от Пола Бакауса (создателя jQuery UI). 23 команды, 7 справочников по типографике/цвету/анимации, PRODUCT.md и DESIGN.md как общая память, Live Mode для итераций в браузере, CLI и Chrome-расширение для детекции anti-patterns. Работает в Cursor, Claude Code, Codex CLI, Gemini CLI и других.

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

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

📌
Суть: 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.


Что внутри

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 teach — одноразовая настройка проекта: интервью про аудиторию, бренд-голос, anti-references, регистр (brand vs product). Пишет PRODUCT.md и DESIGN.md в корень репозитория.
  • /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 (Alpha) — Visual Mode: пик элемента в браузере, комментарий или штрих, три продакшен-варианта через HMR, 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 без имени тоже работает: скилл сам выбирает подход.

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

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

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

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

Live Mode

Альфа-режим итераций прямо в браузере. Запускается /impeccable live. После старта:

  1. Кликаете в браузере по любому элементу.
  2. Пишете комментарий или рисуете штрих поверх.
  3. Жмёте Go.
  4. Через HMR подгружаются три продакшен-варианта прямо в DOM.
  5. Принимаете один — и diff пишется обратно в исходник.

Работает на Vite, Next.js (включая монорепо), SvelteKit, Astro, Nuxt. Умеет автоматически патчить strict-CSP. С v3.0.7 переживает дисконнекты и краши агента — есть durable session journal с командами live status, live resume, live complete.

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

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

  • CLI: npx impeccable detect src/ — детерминированный детектор 27 anti-patterns без LLM и без API-ключа. JSON-вывод для CI и pre-commit хуков. Сканит локальные файлы, html, и публичные URL через Puppeteer.
  • Chrome-расширение: иконка в тулбаре подсвечивает анти-паттерны прямо на любом сайте — на localhost, staging, production или у конкурентов. Ловит градиентный текст, AI-палитры, вложенные карточки, низкий контраст и ещё 20+ правил.

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.

Установка

Универсальный способ:

npx skills add pbakaus/impeccable

Команда сама определяет вашу harness и копирует файлы куда надо. Для Claude Code есть плагин-маркетплейс:

/plugin marketplace add pbakaus/impeccable

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

Для точечной установки можно скачать ZIP под конкретный harness с impeccable.style или скопировать из репозитория dist/<harness>/.


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

ИнструментСильная сторонаКогда выбирать
Impeccable23 команды + 7 справочников + Live Mode + 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. Новый проект с нуля

Классический арк автора: teach → shape → craft. Сначала /impeccable teach собирает 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» и борется с этим в каждой команде:

  • Шрифты-дефолты: 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 — ещё ~20 правил.

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

⚠️
Это не дизайн-система. Impeccable — словарь и процесс, а не готовая система компонентов. Если у вас её нет, скилл поможет её собрать через /impeccable extract и /impeccable document, но за вас не сделает.
  • Live Mode пока в Alpha. Стабильно работает на 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.0.7 в мае). Закрепляйте версию в проекте через npx impeccable skills update руками, а не на автомате.
⚖️
Trade-off. Impeccable снимает большую часть боли «AI пишет код, но дизайн-как-Bootstrap». Взамен требует дисциплины: один раз сесть и заполнить PRODUCT.md, согласовать register и anti-references, договориться с командой про общий словарь команд. Без этого скилл ускорит работу, но не уберёт generic-вкус.

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

Установить скилл: npx skills add pbakaus/impeccable.
Запустить /impeccable teach в новом проекте — заполнить 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/ --fast --json как блокирующий гейт против regression-патернов.
Раз в две недели — npx impeccable skills update для свежих anti-patterns и команд.
При шипе — pre-ship gauntlet: audit → clarify → harden.

Ссылки


По теме

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