Ir para o guia de uso
apple-designpor Emil Kowalski

Apple Design Skill.

Um skill para Claude Code e Codex voltado a pesquisa de UX: gestos, movimento físico e hierarquia espacial da Apple traduzidos para a web.

  • UX & Research
  • Código de 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
Metadados e cabeçalhos de seção lidos do arquivo original em 14/09/2026 · 22.559 caracteres no total

01 O que faz

O Que o Skill apple-design Faz no Claude Code e no Codex

Resumo, fluxo de trabalho e resultados, todos lidos do SKILL.md do skill.

Do SKILL.mdLido em 14/09/2026 · não é uma execução registrada

Nos termos do próprio skill

Apple Design condensa as palestras de interface da WWDC da Apple, principalmente Designing Fluid Interfaces (WWDC 2018), em regras para construir interfaces web fluidas e físicas. É voltado a designers e desenvolvedores que trabalham com interfaces orientadas a gestos: arrastar, deslizar, sheets, springs, momentum, transições interrompíveis, materiais translúcidos e profundidade, tipografia (tamanho óptico, tracking, leading) e comportamento de movimento reduzido.

O fio condutor é que o movimento deve começar a partir do valor atual em tela, herdar a velocidade do usuário, projetar o momentum para frente, e ser agarrável e reversível a qualquer instante. Springs substituem animações de duração fixa porque são inerentemente interrompíveis e sensíveis à velocidade, e o skill se encerra com os oito princípios de design da Apple usados como vocabulário compartilhado.

O que ele produz

  • CSS de feedback de pressão que reduz a escala do controle em :active com uma transição ease-out de 100ms.
  • Chamadas de spring de movimento mostrando o padrão criticamente amortecido e a variante de bounce por momentum lado a lado.
  • Um helper project() implementando projeção de momentum com decelerationRate padrão de 0.998.
  • CSS de transparência reduzida que substitui barras de ferramentas translúcidas por fundos sólidos e sem blur.
Veja o exemplo de prompt ↗

Como funciona

  1. 01
    Responda no pointer-down

    O feedback pertence à pressão, não à soltura: destaque o controle no instante em que é pressionado, e trate qualquer coisa não essencial no caminho de entrada, incluindo o atraso de toque de ~300ms, como uma regressão.

  2. 02
    Acompanhe o Ponteiro 1:1

    Use Pointer Events com captura para que o rastreamento sobreviva ao ponteiro sair dos limites do elemento, e respeite onde o usuário agarrou em vez de encaixar no centro do elemento.

  3. 03
    Torne o movimento interruptível

    Um elemento em movimento precisa ser agarrável e reversível em pleno voo; o usuário nunca deve ter que esperar a animação atual terminar antes de redirecioná-la.

  4. 04
    Modele o movimento com springs

    Uma spring absorve nova entrada simplesmente alterando seu alvo, então o movimento permanece contínuo; scripts de duração fixa não têm nada para reatribuir alvo.

  5. 05
    Transfira a velocidade de soltura

    Dê à spring a velocidade do ponteiro no momento da soltura para que não haja costura entre arrastar e animar; normalize pela distância restante quando a API exigir velocidade relativa.

  6. 06
    Projete o momentum e só então encaixe

    Não encaixe a partir de onde o dedo soltou; projete a posição de repouso da mesma forma que a desaceleração de rolagem faria e escolha o alvo de encaixe mais próximo dessa projeção.

02 Encontre o ideal para você

Quando Usar a Skill apple-design

Use a skill apple-design no Claude Code ou Codex quando o trabalho for pesquisa de UX desse tipo. Adequação e limites abaixo são extraídos do próprio arquivo da skill.

Boa Combinação

  • Construir ou revisar UI orientada a gestos, como arrastar, deslizar, sheets, momentum e transições interruptíveis.
  • Trabalhar com materiais translúcidos e profundidade, onde barras de navegação, barras de ferramentas e sheets atuam como uma camada funcional flutuante.
  • Trabalho de tipografia em escala de tamanho, onde o tamanho óptico, o tracking e o leading precisam mudar com o tamanho.
  • Revisões de acessibilidade em que movimento reduzido, transparência reduzida e contraste aumentado são incorporados aos componentes em vez de adicionados posteriormente.
  • Equipes que querem os princípios de design da Apple como vocabulário compartilhado explícito ao debater uma decisão.

Conheça os Limites

  • Animação pré-roteirizada ou de duração fixa, que o skill descarta assim que o usuário pode tocar no elemento.
  • Reconhecedores que só relatam um estado final de gesto, pois descartam o rastreamento contínuo do qual o feedback depende.
  • Chrome opaco que consome uma faixa fixa em vez de permitir que o conteúdo role sob uma camada translúcida.
  • Confirmações como hábito padrão; o arquivo as reserva apenas para ações genuinamente destrutivas e irreversíveis.

O Que Fornecer

  • O código do gesto e seu histórico de ponteiroTraga a implementação de Pointer Events, já que o skill espera setPointerCapture e um histórico curto de velocidade/posição, e não apenas o ponto atual.
  • Uma biblioteca de spring que reatribui velocidadeO mapeamento web passa por Motion / Framer Motion, e a biblioteca precisa carregar a velocidade através de uma reatribuição de alvo; nem toda implementação de spring faz isso.
  • O chrome translúcido que você quer revisadoBarras de ferramentas, barras de navegação e sheets são construídas como camadas translúcidas com backdrop-filter blur e um fundo semitransparente, com o conteúdo rolando por baixo delas.

03 Dentro da skill

Regras que o skill apple-design dá ao Claude Code e ao Codex

8 instruções concretas, padrões e limites que o SKILL.md define para o agente — a parte do arquivo que muda o resultado.

  1. Use por padrão uma spring criticamente amortecida

    Comece a maior parte da UI com damping 1.0 para que se estabilize sem overshoot; adicione bounce, em torno de damping 0.8, apenas onde o próprio gesto carregou momentum, como em um flick ou na soltura de um arrasto.

  2. Anime a Partir do Valor de Apresentação

    Ao interromper, leia a transformação em tela ativa do elemento e inicie a nova animação a partir dela; começar a partir do valor lógico ou de destino produz um salto visível.

  3. Não Controle Gestos com Transições CSS

    Transições CSS e @keyframes não podem ser agarradas e revertidas suavemente em pleno movimento, então o movimento controlado por gestos deve ser tratado por uma biblioteca de springs.

  4. Divida o Movimento 2D em Dois Springs

    Execute springs independentes de X e Y em vez de um único spring sobre uma distância 2D, porque os eixos saem de sincronia quando suas velocidades diferem.

  5. Use a Projeção da Apple, Não a do Livro-Texto

    O v²/(2·decel) do livro-texto de física não é o que a Apple usa; use a forma de decaimento exponencial com decelerationRate 0.998 para uma sensação de rolagem normal, ou 0.99 para algo mais responsivo.

  6. Combine a Velocidade em uma Reversão

    Trocar uma animação por outra no momento em que um gesto reverte cria uma descontinuidade de velocidade, uma parede de tijolos; escolha uma biblioteca de springs que redefina o alvo a partir da velocidade atual.

  7. Nunca Sobreponha Superfícies Translúcidas Claras

    O peso do material é como a hierarquia é lida: materiais mais pesados separam regiões estruturais e os mais leves destacam elementos interativos, então mantenha as camadas translúcidas claras separadas umas das outras.

  8. Nunca Use um Único Valor de Tracking para Todos os Tamanhos

    O letter-spacing é específico do tamanho: texto de display grande exige tracking negativo enquanto texto pequeno exige tracking levemente positivo, então um letter-spacing fixo estará errado em algum lugar.

04 Coloque em prática

Instale apple-design no Claude Code ou Codex

Um comando npx skills add, depois uma primeira tarefa no seu agente e uma checklist para o resultado.

Adicione apple-design ao Claude Code, Codex ou Seu Agente

Rode no seu projeto; o instalador pergunta a qual agente adicioná-lo.

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

Forma genérica do CLI skills para skills/apple-design/SKILL.md; o repositório pode documentar seu próprio caminho.

Dê à Skill uma Primeira Tarefa de Pesquisa de UX

Escrito nos próprios termos do skill; substitua as partes entre colchetes pelo seu material.

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.

Fonte: escrito a partir do SKILL.md nos próprios termos do skill.

Verifique o Primeiro Resultado

O que o próprio SKILL.md diz sobre como é um resultado correto:

  • Agarre novamente um elemento em fechamento em pleno movimento e confirme que ele segue o dedo em vez de concluir seu fechamento primeiro.
  • Reverta um gesto e observe se há uma descontinuidade de velocidade, o que significa que a velocidade não foi combinada durante o redirecionamento.
  • Teste com pessoas reais em contexto real, já que o julgamento do movimento falha na máquina de um desenvolvedor.
  • Reproduza o movimento em câmera lenta ou quadro a quadro, porque os defeitos mais interessantes são invisíveis em velocidade normal.
  • Confirme que o alvo de destino veio do ponto final projetado, e não do ponto de liberação.
  • Verifique a variante de transparência reduzida: superfícies translúcidas devem se tornar mais opacas ou sólidas, com a opacidade do fundo aumentada e o blur reduzido.

No OpenDesign importe o apple-design a partir do seu link SKILL.md: Plugins → Add → Skill → Import from link, depois selecione-o na barra superior.

05 Código aberto, rastreável

Fonte, Licença e Verificação

De onde vêm os fatos desta página e quando foram verificados pela última vez.

Repository
github.com/emilkowalski/skills Branch main
Arquivo da skill
skills/apple-design/SKILL.md Checksum do conteúdo registrado na verificação; commit d23d7f8
License
MIT De LICENSE.
Estrelas do repositório
37.516 Snapshot do GitHub tirado em 14/09/2026 para todo o repositório emilkowalski/skills, que contém 9 skills neste catálogo. Não é uma classificação ou contagem de uso para apple-design.
Verificado pelo OpenDesign
14/09/2026 Arquivo de origem, caminho, texto da licença e contagem de estrelas foram verificados. Não integrado ao OpenDesign principal (verificado em 28/08/2026); uma execução ao vivo não foi registrada nesta página.

Dentro do SKILL.md

  1. 1. Resposta — elimine a latênciaResponda ao toque no pointer-down, auditore toda latência, mantenha o feedback contínuo durante toda a interação.
  2. 2. Manipulação direta — rastreamento 1:1Cole o conteúdo ao ponteiro, respeite o offset de captura, mantenha um breve histórico de velocidade.
  3. 3. Interruptibilidade — o princípio mais importanteNunca bloqueie a entrada, anime a partir do valor de apresentação, combine a velocidade na reversão, divida springs 2D.
  4. 4. Comportamento em vez de animação — use springsA relação de amortecimento e a resposta substituem a física; amortecimento 1.0 por padrão, bounce apenas para momentum.
  5. 5. Transferência de velocidade — a costura entre arrastar e animarPasse a velocidade de soltura para o spring, normalizando pela distância restante quando necessário
A Descrição da Própria Skill
"A abordagem da Apple para design de interface e movimento fluido e físico, traduzida para a web. Use ao criar ou revisar UI orientada a gestos, animações de mola, interações de arrastar/deslizar/folha, transições com momentum e interruptíveis, materiais translúcidos e profundidade, tipografia (dimensionamento óptico, tracking, leading), movimento reduzido, ou os fundamentos de design (feedback, consistência espacial, contenção) por trás de interfaces no estilo Apple."

Descrição do front-matter do SKILL.md. O arquivo completo tem cerca de 22.559 caracteres. Leia o arquivo completo no GitHub.

Apple Design

Execute apple-design em uma tarefa real de pesquisa de UX.

Baixe OpenDesign, importe apple-design através do link do SKILL.md, cole o prompt acima e leia o plano antes do resultado.

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

OpenDesign Desktop

Um design system. Sua marca consistente em tudo

No Vibe Design Workspace completo, aplique as mesmas regras de marca a sites, apresentações, protótipos interativos, dashboards, imagens e vídeos HTML. Conecte Codex, Claude Code, Cursor e outros agentes de código locais e crie de graça.

  • Sites, apresentações, protótipos, dashboards, imagens e vídeo
  • Mais de 140 design systems e a biblioteca completa de templates e skills
  • Codex local e mais de 21 agentes de código · Grátis
Baixar grátis

Disponível para macOS e Windows