Скилл Apple для Claude за 6 секунд: установка и разбор интерфейса

Как понять, что скилл встал

Замер установки: от команды до готовой папки прошло шесть секунд, на диск легли тринадцать папок и файл с контрольными суммами на 3193 байта.

Три проверки, каждая занимает секунды.

Первая: посмотри, что лежит на диске.

ls .agents/skills

Должны появиться тринадцать имён. Если список пуст, установка шла не в той папке, разбор ниже.

Вторая: спроси самого агента, видит ли он новое умение. Напиши в Claude Code: «Какие скиллы тебе сейчас доступны?» В ответе должно прозвучать apple-design. Claude Code читает не саму папку .agents, а ссылки, которые установщик кладёт в .claude/skills, поэтому лишних действий не нужно.

Третья, самая честная: попроси агента назвать значения пружины для выдвижной панели. Правильный ответ: затухание 0.8, отклик 0.3. Если в ответ звучат общие слова про плавность, файл он не прочитал.

Что внутри на самом деле, и почему это не про «премиально»

Здесь главное расхождение с тем, как этот скилл пересказывают.

Проверка поиском по файлу: слово «premium» встречается внутри ноль раз, слово «audit» один раз и не в значении разбора интерфейса.

Слова «премиум» внутри нет ни разу. Это не набор украшений и не тема оформления. Один файл на 290 строк, семнадцать разделов, и весь он про физику интерфейса: перевод докладов Apple с конференции для разработчиков, прежде всего «Designing Fluid Interfaces» 2018 года, на язык веба.

Сквозная мысль сформулирована в самом файле так: интерфейс оживает, когда движение стартует с текущего значения на экране, наследует скорость руки, проецирует инерцию вперёд и может быть перехвачено в любой момент.

Разберём три правила, которые дают тот самый эффект дорогого продукта.

Отклик на нажатие, а не на отпускание. Кнопка обязана подсветиться в момент, когда палец коснулся её, а не когда отпустил. Ожидание отпускания читается как мёртвый интерфейс. В файле это первое правило, и оно названо фундаментом, на котором стоит всё остальное.

Перетаскивание держится за точку захвата. Когда человек тащит карточку, она обязана оставаться приклеенной к пальцу и помнить, за какое место её взяли. Прыжок центром элемента к пальцу ломает иллюзию мгновенно.

Прерываемость важнее красоты. Любая анимация обязана перехватываться и разворачиваться на середине. Закрывающееся окно, которое человек схватил снова, обязано пойти за пальцем, а не досмотреть закрытие до конца и только потом открыться. Отсюда следствие: переходы и покадровые анимации средствами стилей для жестов не годятся, их нельзя схватить на лету. Годятся пружины, они по своей природе стартуют с текущего значения.

Таблица, ради которой стоит вернуться

Пружина задаётся двумя понятными числами вместо трёх физических. Затухание отвечает за перелёт: единица означает мягкую посадку без отскока, меньше единицы даёт отскок. Отклик отвечает за скорость выхода к цели в секундах, и это не длительность: у пружины фиксированной длительности нет вовсе.

Значения, которые Apple применяет в своих интерфейсах:

Правило выбора простое. По умолчанию ставь затухание 1.0: это спокойное движение без отскока, которое не отвлекает. Отскок добавляй только тогда, когда самому жесту предшествовал импульс: бросок, щелчок, отпускание после перетаскивания. Отскок у меню, которое просто проявилось, ощущается неправильно; отскок у карточки, которую подбросили пальцем, ощущается верно.

Симптом в твоём интерфейсе и правило, которое его чинит

Эта таблица работает без статьи рядом. Открываешь через неделю, когда возник новый вопрос.

Что ещё приезжает вместе с ним

Скиллы ставятся набором, и остальные двенадцать не мусор. Вот за что отвечает каждый, чтобы ты знал, о чём просить агента.

Если ты пока выбираешь, чем вообще собирать интерфейс, сначала посмотри обзор инструментов, которые делают UI из текста, а уже потом ставь этот набор поверх выбранного.

Готовый промпт для разбора твоего интерфейса

Скопируй целиком и вставь в Claude Code внутри своего проекта. Он написан так, чтобы агент дал конкретику, а не пересказ.

Прочитай скилл apple-design целиком.
Затем пройди по интерфейсу этого проекта и найди места, которые нарушают его правила.
На каждую находку дай ровно три строки:
1) файл и строка,
2) какое правило нарушено и его номер раздела в скилле,
3) конкретная правка с числами, если правило задаёт числа.
Не предлагай переписать всё заново. Не трогай бизнес-логику.
Начни с того, что ломает ощущение отклика: реакция на нажатие, перетаскивание, прерываемость.

Важное про ожидания. Скилл не запускает сканер и не выдаёт отчёт с уровнями важности: это правила, которые агент читает перед тем, как трогать твой код. Качество разбора равно качеству чтения твоего проекта агентом, и на большом проекте имеет смысл давать ему по одному экрану за раз.

Что ломается при установке

Ответ выше приведён дословно с экрана установки.

Пытаешься поставить один скилл отдельно. Логично написать путь до нужной папки, и это не работает:

npx skills@latest add emilkowalski/skills/apple-design
Repository cloned
No skills found
No valid skills found. Skills require a SKILL.md with name and description.

Установщик скачивает набор, но не находит по указанному пути описание скилла и выходит ни с чем. Ставится только весь набор целиком, тринадцать штук. Лишние не мешают: агент подтягивает нужный по описанию задачи.

Пусто в списке после установки. Значит команда выполнялась не в той папке. Скиллы кладутся туда, где ты находишься в момент запуска, а не в общую системную папку. Перейди в корень проекта и повтори.

Агент не видит скилл. Открой .claude/skills и проверь, что там лежат ссылки на папки из .agents/skills. Установщик делает их сам, но если каталог проекта появился позже установки, ссылок не будет. Повторный запуск команды это чинит.

Что это даёт на практике

Набор собрал Эмиль Ковальски, он делал интерфейсы в Vercel и Linear, и это его многолетний опыт, выложенный под свободной лицензией MIT. Набор собрал около 38 тысяч отметок и больше двух тысяч копий, то есть проверен не только автором.

Смысл не в том, что агент станет дизайнером. Смысл в том, что у него появляется словарь и набор чисел вместо догадок. Просьба «сделай красивее» не содержит ни одного проверяемого утверждения, поэтому агент каждый раз изобретает своё. Просьба «проверь по правилам apple-design» проверяема: либо кнопка отвечает на нажатие, либо нет.

Источники

• Репозиторий скиллов и команда установки: github.com/emilkowalski/skills, лицензия MIT
• Доклад, на котором построен скилл: Designing Fluid Interfaces, WWDC 2018
• Рекомендации Apple по интерфейсам: Human Interface Guidelines

Если хочешь собрать под этот интерфейс ещё и движение на сайте или сначала собрать макет словами, соседние разборы лежат рядом.

Памятка: что сделать по порядку

Частые вопросы