Перейти к руководству
apple-designавтор Emil Kowalski

Apple Design Skill.

Skill для Claude Code и Codex в области UX-исследований: жесты, физическое движение и пространственная иерархия Apple, адаптированные для веба.

  • UX и исследования
  • UI-код
emilkowalski/skills · skills/apple-design/SKILL.mdSKILL.md
--- name: apple-design description: Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style … --- ## The Core Idea ## 1. Response — kill latency ## 2. Direct manipulation — 1:1 tracking ## 3. Interruptibility — the single most important principle ## 4. Behavior over animation — use springs ## 5. Velocity handoff — the seam between drag and animation
Преамбула и заголовки секций считаны из исходного файла 2026-09-14 · 22 559 символов всего

01 Что делает

Что делает skill apple-design в Claude Code и Codex

Сводка, рабочий процесс и результаты — всё прочитано из SKILL.md этого skill.

Из SKILL.mdПрочитано 14.09.2026 · не запись выполнения

Словами самого skill

Apple Design перерабатывает выступления Apple о интерфейсах на WWDC, в первую очередь Designing Fluid Interfaces (WWDC 2018), в правила для создания плавных, физичных веб-интерфейсов. Он предназначен для дизайнеров и разработчиков, работающих с интерфейсами на основе жестов: перетаскивание, свайпы, шиты, пружины, инерция, прерываемые переходы, полупрозрачные материалы и глубина, типографика (оптический размер, трекинг, интерлиньяж) и поведение при сниженной анимации.

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

Что он выдаёт

  • CSS для обратной связи при нажатии, масштабирующий элемент управления при :active с переходом ease-out 100 мс.
  • Вызовы spring-анимации, показывающие рядом критически затухающий вариант по умолчанию и вариант с инерционным отскоком.
  • Хелпер project(), реализующий проекцию инерции с decelerationRate по умолчанию 0.998.
  • CSS для сниженной прозрачности, заменяющий полупрозрачные панели инструментов сплошным фоном без размытия.
Смотрите пример запроса ↗

Как это работает

  1. 01
    Реагировать на pointer-down

    Обратная связь относится к нажатию, а не к отпусканию: выделяйте элемент управления в момент нажатия и относитесь к любой несущественной задержке на пути ввода, включая ~300 мс задержку тапа, как к регрессии.

  2. 02
    Отслеживать указатель 1:1

    Используйте Pointer Events с захватом (capture), чтобы отслеживание сохранялось даже при выходе указателя за границы элемента, и учитывайте точку, за которую пользователь взялся, а не привязывайтесь к центру элемента.

  3. 03
    Сделайте движение прерываемым

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

  4. 04
    Моделируйте движение с помощью пружин

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

  5. 05
    Передавайте скорость отпускания

    Передавайте пружине скорость указателя в момент отпускания, чтобы не было разрыва между перетаскиванием и анимацией; нормализуйте по оставшемуся расстоянию, если API требует относительную скорость.

  6. 06
    Прогнозируйте инерцию, затем привязывайте

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

02 Определите своё применение

Когда использовать скилл apple-design

Используйте скилл apple-design в Claude Code или Codex, когда задача — UX-исследование такого типа. Область применения и ограничения ниже взяты из файла самого скилла.

Хорошо подходит

  • Создание или проверка UI на основе жестов, такого как перетаскивание, свайп, шторка, инерция и прерываемые переходы.
  • Работа с полупрозрачными материалами и глубиной, где навигационные панели, тулбары и шторки выступают как плавающий функциональный слой.
  • Работа с типографикой в масштабе размеров, где оптический размер, трекинг и интерлиньяж должны меняться в зависимости от размера.
  • Проверки доступности, где сниженное движение, сниженная прозрачность и повышенный контраст встроены в компоненты, а не добавлены поверх.
  • Команды, которым нужны принципы дизайна Apple как явный общий словарь для аргументации решений.

Знайте границы

  • Заранее прописанная или анимация с фиксированной длительностью, которую skill исключает, как только пользователь может коснуться элемента.
  • Распознаватели, которые сообщают только финальное состояние жеста, поскольку они отбрасывают непрерывное отслеживание, от которого зависит обратная связь.
  • Непрозрачный chrome, занимающий фиксированную полосу, вместо того чтобы позволять контенту скроллиться под полупрозрачным слоем.
  • Подтверждения как привычка по умолчанию; файл оставляет их только для по-настоящему разрушительных, необратимых действий.

Что предоставить

  • Код жестов и его история указателяВозьмите реализацию Pointer Events, поскольку skill ожидает setPointerCapture и короткую историю скорости/позиции, а не только текущую точку.
  • Библиотека пружин, которая перенацеливает скоростьВеб-маппинг проходит через Motion / Framer Motion, и библиотека должна переносить скорость через повторное нацеливание; не каждая реализация пружины это делает.
  • Полупрозрачный chrome, который вы хотите проверитьТулбары, навигационные панели и шторки строятся как полупрозрачные слои с backdrop-filter blur и полупрозрачным фоном, а контент скроллится под ними.

03 Внутри скилла

Правила, которые skill apple-design задаёт Claude Code и Codex

8 конкретных инструкций, значений по умолчанию и ограничений, которые SKILL.md задаёт для агента — та часть файла, которая влияет на результат.

  1. По умолчанию используйте пружину с критическим затуханием

    Начинайте большинство UI с затухания 1.0, чтобы оно устанавливалось без перелёта; добавляйте отскок, около затухания 0.8, только там, где сам жест несёт инерцию, например резкий взмах или отпускание при перетаскивании.

  2. Анимируйте от отображаемого значения

    При прерывании считывайте текущую трансформацию элемента на экране и начинайте новую анимацию оттуда; старт от логического или целевого значения даёт видимый скачок.

  3. Не управляйте жестами через CSS-переходы

    CSS-переходы и @keyframes нельзя плавно захватить и обратить в процессе, поэтому движение, управляемое жестом, должно обрабатываться пружинной библиотекой.

  4. Разбивайте 2D-движение на две пружины

    Запускайте независимые пружины по X и Y вместо одной пружины на 2D-расстояние, потому что оси расходятся при разных скоростях.

  5. Используйте проекцию Apple, а не учебную

    Формула из учебника физики v²/(2·decel) — не то, что использует Apple; используйте экспоненциальное затухание с decelerationRate 0.998 для обычного ощущения скролла или 0.99 для более отзывчивого.

  6. Смешивайте скорость через реверс

    Замена одной анимации на другую в момент обращения жеста создаёт разрыв скорости, «стену»; выбирайте пружинную библиотеку, которая перенацеливается от текущей скорости.

  7. Никогда не накладывайте лёгкие полупрозрачные поверхности друг на друга

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

  8. Никогда не используйте одно значение трекинга для всех размеров

    Межбуквенный интервал зависит от размера: крупный дисплейный текст требует отрицательного трекинга, а мелкий — слегка положительного, поэтому фиксированный letter-spacing где-то окажется неверным.

04 Применение

Установите apple-design в Claude Code или Codex

Одна команда npx skills add, затем первая задача в вашем агенте и чек-лист для результата.

Добавьте apple-design в Claude Code, Codex или ваш агент

Запустите в своём проекте; установщик спросит, какому агенту его добавить.

Terminal
npx skills add https://github.com/emilkowalski/skills --skill apple-design

Универсальная форма CLI skills для skills/apple-design/SKILL.md; репозиторий может документировать собственный путь.

Дайте скиллу первую задачу по UX-исследованию

Написано в терминах самого skill; замените части в квадратных скобках своим материалом.

Starter prompt
I'm building a bottom sheet in [React] that users drag down to dismiss. It currently uses a CSS transition, so a flick snaps from wherever I released and the sheet can't be grabbed again while it's closing. Rework it with Pointer Events and a spring so it tracks the finger 1:1, hands off the release velocity, and projects momentum to pick the snap point.

Источник: составлено по SKILL.md в терминах самого skill.

Проверьте первый результат

Что сам SKILL.md считает правильным результатом:

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

В OpenDesign импортируйте apple-design по ссылке на его SKILL.md: Plugins → Add → Skill → Import from link, затем выберите его в верхней панели.

05 Открытый исходный код, проверяемость

Источник, лицензия и проверка

Откуда взяты факты на этой странице и когда они были последний раз проверены.

Repository
github.com/emilkowalski/skills Ветка main
Файл skill
skills/apple-design/SKILL.md Контрольная сумма содержимого зафиксирована при верификации; коммит d23d7f8
License
MIT Из LICENSE.
Звёзды репозитория
37 516 Снимок GitHub от 2026-09-14 для всего репозитория emilkowalski/skills, который содержит 9 skills из этого каталога. Не является рейтингом или счётчиком использования для apple-design.
Проверено OpenDesign
2026-09-14 Исходный файл, путь, текст лицензии и количество звезд были проверены. Не входит в основной комплект OpenDesign (проверено 2026-08-28); живой запуск не был записан на этой странице.

Внутри SKILL.md

  1. 1. Отклик — устраните задержкуОтвечайте на нажатие указателя, проверяйте каждую задержку, поддерживайте непрерывную обратную связь на протяжении всего взаимодействия.
  2. 2. Прямое манипулирование — трекинг 1:1Приклеивайте контент к указателю, учитывайте смещение захвата, храните короткую историю скорости.
  3. 3. Прерываемость — самый важный принципНикогда не блокируйте ввод, анимируйте от текущего презентационного значения, смешивайте скорость при реверсе, разделяйте 2D-пружины.
  4. 4. Поведение важнее анимации — используйте пружиныКоэффициент затухания и response заменяют физику; затухание 1.0 по умолчанию, отскок — только для инерции.
  5. 5. Передача скорости — стык между перетаскиванием и анимациейПередавайте скорость отпускания в пружину, нормализуя её по оставшемуся расстоянию при необходимости
Собственное описание skill
«Подход Apple к дизайну интерфейсов и плавному, физичному движению, адаптированный для веба. Используйте при создании или проверке UI с жестами, spring-анимаций, drag/swipe/sheet-взаимодействий, инерционных и прерываемых переходов, полупрозрачных материалов и глубины, типографики (оптические размеры, трекинг, интерлиньяж), reduced-motion или основ дизайна (отклик, пространственная последовательность, сдержанность), лежащих в основе интерфейсов в стиле Apple.»

Описание из front-matter файла SKILL.md. Полный файл составляет около 22 559 символов. Прочитать полный файл на GitHub.

Apple Design

Запустите apple-design на реальной задаче UX-исследования.

Скачайте OpenDesign, импортируйте apple-design по ссылке на его SKILL.md, вставьте промпт выше и прочитайте план перед результатом.

Терминал
npx skills add https://github.com/emilkowalski/skills --skill apple-design

OpenDesign для компьютера

Одна дизайн-система. Единый образ бренда во всех материалах

В полном Vibe Design Workspace одни и те же правила бренда работают для сайтов, слайдов, интерактивных прототипов, дашбордов, изображений и HTML-видео. Подключите локальные Codex, Claude Code, Cursor и другие кодинг-агенты и создавайте бесплатно.

  • Сайты, слайды, прототипы, дашборды, изображения и видео
  • Более 140 дизайн-систем и полная библиотека шаблонов и навыков
  • Локальный Codex и более 21 кодинг-агента · Бесплатно
Скачать бесплатно

Для macOS и Windows