Hallmark — дизайн-навык для AI-агентов, который отказывается выглядеть как сгенерированный
📂 Исходный код на GitHubНавык проектирования интерфейсов для AI-агентов (Claude Code, Codex, Cursor, OpenCode), который борется с «AI-шаблонностью»: 50 тем-материалов, режимы build, redesign и audit, режим Custom без шаблонов, библиотека из 755 фотографий с открытыми лицензиями и проверки sloplint в реальном браузере. Создан командой Together AI.
Hallmark — это навык (skill) для AI-агентов программирования: Claude Code, Codex CLI, Cursor и OpenCode. Его задача проста и конкретна: не дать сгенерированному интерфейсу выглядеть как сгенерированный. Проект создан командой Together AI и дорос до второй крупной версии: 50 тем оформления, сборка страницы под задачу посетителя и проверки в настоящем браузере. На GitHub у навыка 48,3 тыс. звёзд. Сайт проекта — usehallmark.com.
Что нового во второй версии
Вторая версия меняет подход целиком. Вместо фиксированного набора правил — «материалы», из которых собирается страница. Вместо самокритики перед выдачей — реальный рендеринг и проверка на восьми ширинах экрана. Главное:
- 50 тем. Каждая тема — это материал: бумага, типографика, палитра, поверхности, свои компоненты и текстуры. Сборка раскладывает страницу внутри материала, а не копирует шаблон.
- Страница растёт из задачи. Страница бронирования бронирует, магазин продаёт, рассылка подписывает. Целевое действие стоит там, где его ожидает найти посетитель, и страница им заканчивается.
- Custom по запросу. Скажите «custom» — и Hallmark спроектирует страницу только из вашего промпта, по тем же правилам и проверкам.
- Ваш реальный продукт. Навык принимает URL, dev-сервер или приложение и сам снимает скриншоты.
- Настоящие фотографии. В комплекте 755 фотографий с открытыми лицензиями. Они подбираются по теме страницы и получают подпись с авторством.
- Redesign и audit.
/hallmark redesign <путь>перестраивает страницу, сохраняя контент и логику./hallmark audit <путь>только докладывает о проблемах.
Три уровня проверок
Проверки делятся на уровни, и у каждого своя сила.
Floor — то, что никогда не попадёт в результат: контраст, фокус, поддержка reduced motion, выдуманные факты, сломанная мобильная вёрстка.
Reflex — типовые привычки модели: «бровка» над каждым заголовком, надписи капсом с разрядкой, одно цветное слово в заголовке, страница из пустых рамок или одних фотографий, hero-секция, не попадающая в экран, кнопка подписки на email в конце каждой страницы, форма, которая благодарит за отправку, ничего не отправив. Если у сборки есть причина, такой пункт можно обойти — но с записью в отчёте.
Finish — детали ремесла. Они никогда не блокируют выпуск.
Последнее слово остаётся за ревьюером с чистым контекстом: отдельный субагент смотрит готовую страницу так, как её увидит первый посетитель.
Как проходит сборка
- Pre-flight. Навык читает проект: шрифты, палитру, фреймворк, закреплённый файл
design.md. Один раз спрашивает материал: фотографии, скриншоты, реальные цифры. Ничего не выдумывается. - Раздача тем. Скрипт
theme.mjs dealпредлагает три темы, которые подходят под промпт и прошли прошлые проверки. Командаdrawраскладывает анатомию страницы по её задаче. - Hero отдельно. Hero-секция строится, рендерится и проходит холодное ревью до того, как существует остальная страница.
- Проверка в браузере. sloplint.mjs с флагом
--renderпроверяет страницу на восьми ширинах. Затем субагент смотрит результат свежим взглядом.
Каждая страница — самодостаточные HTML и CSS. В первом CSS-комментарии записаны все решения, которые приняла сборка.
Тема — это материал
Тема ничего не говорит о содержании страницы и о порядке блоков. Поэтому два промпта в одной теме дают две разные страницы, а не перекраску одного шаблона. Каждая тема — один файл не больше 8 КБ рядом с картинкой готовой страницы. Сборка читает ровно одну тему. Полный каталог лежит в папке themes, витрина со скриншотами — на usehallmark.com.
Режим Custom
Скажите «custom» — и Hallmark отбрасывает темы: никакого плана, компонентов и рецепта палитры. Остаются уровень Floor, обычные проверки и короткий файл указаний direction.md. Его задача — найти одну идею, которая есть только у этого клиента, и дать ей вести страницу.
Redesign и audit
Навык не трогает существующий дизайн, пока вы его не назовёте:
/hallmark redesign ./src/app
/hallmark audit ./index.html
Полный redesign сохраняет контент и логику работы, но меняет систему и вёрстку. Скажите «keep the layout» — получите только смену стиля. Скажите «polish» — правку одних лишь типовых признаков. Перед переделкой sloplint --before записывает каждую ссылку, поле, обработчик и заголовок. После — sloplint --kept проваливает результат, если что-то из этого пропало. Итог сдаётся в виде сравнения «до и после» рядом.
Установка
npx skills add nutlope/hallmark -g
Флаг -g ставит навык для всех проектов. Без него — только в текущий. Нужен Node 18 или новее. Проверки в браузере (sloplint --render, скриншоты) дополнительно требуют npm i -g puppeteer-core и Chrome. Без них статические проверки всё равно работают.
| Среда | Куда попадает | Как вызвать |
|---|---|---|
| Claude Code | ~/.claude/skills/hallmark |
/hallmark <промпт> или опишите новую сборку |
| Codex CLI | ~/.agents/skills/hallmark |
$hallmark <промпт> или опишите новую сборку |
| Cursor | находит копии сам | /hallmark <промпт> или опишите новую сборку |
| OpenCode | находит копии сам | /hallmark <промпт> или опишите новую сборку |
Дополнительно:
- Только одна среда:
npx skills add nutlope/hallmark -g --agent claude-code(такжеcodex,opencode,cursor,github-copilot). - Как плагин Claude Code:
/plugin marketplace add nutlope/hallmark, затем/plugin install hallmark@hallmark(вызов —/hallmark:hallmark). - Из клона репозитория:
node skills/hallmark/scripts/install.mjsпроверяет каждую тему и справочник перед копированием. Скриптinstall-hook.mjsдобавляет в Claude Code проверку Floor при правках. - Проверить любую страницу:
node skills/hallmark/scripts/sloplint.mjs <файл-или-папка> --render. - Если навык не сработал сам, назовите его: «use hallmark to build ...».
Фотографии вместо стока
Библиотека photos.json не хранит изображения. Она перечисляет фотографии с Wikimedia Commons, и у каждой своя лицензия: CC0, public domain, CC BY или CC BY-SA. Hallmark подписывает автора каждой использованной фотографии прямо на странице. Стоковые сервисы — Unsplash, Pexels, Pixabay — не используются: их условия запрещают AI-инструментам выбирать их изображения.
Вдохновение
Проект ссылается на Impeccable, frontend-design, Open Design, Kami, taste-skill, huashu-design, UI UX Pro Max, навыки Emil Kowalski и Web Interface Guidelines.
Лицензия
MIT. Используйте, форкайте, выпускайте.
Источник: https://github.com/Nutlope/hallmark