Vai alla guida all’uso
apple-designdi Emil Kowalski

Apple Design Skill.

Uno skill per Claude Code e Codex dedicato alla ricerca UX: gesture, movimento fisico e gerarchia spaziale di Apple tradotti per il web.

  • UX & Research
  • Codice 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
Front matter e intestazioni di sezione lette dal file upstream il 14-09-2026 · 22.559 caratteri in totale

01 Cosa fa

Cosa Fa la Skill apple-design in Claude Code e Codex

Sintesi, workflow e output, tutto letto dal SKILL.md della skill.

Dal SKILL.mdLetto il 14-09-2026 · non è un'esecuzione registrata

Nelle parole della skill

Apple Design distilla gli interventi sull'interfaccia del WWDC di Apple, principalmente Designing Fluid Interfaces (WWDC 2018), in regole per costruire interfacce web fluide e fisiche. È pensata per designer e sviluppatori che lavorano su interfacce guidate da gesti: trascinamento, scorrimento, sheet, molle, momentum, transizioni interrompibili, materiali translucidi e profondità, tipografia (dimensionamento ottico, tracking, leading) e comportamento con movimento ridotto.

Il filo conduttore è che il movimento dovrebbe partire dal valore attuale visualizzato sullo schermo, ereditare la velocità dell'utente, proiettare il momentum in avanti ed essere afferrabile e reversibile in qualsiasi istante. Le molle sostituiscono le animazioni a durata fissa perché sono intrinsecamente interrompibili e sensibili alla velocità, e la skill si conclude con gli otto principi di design di Apple usati come vocabolario condiviso.

Che cosa produce

  • CSS di feedback alla pressione che ridimensiona il controllo su :active con una transizione ease-out di 100ms.
  • Chiamate spring per il movimento che mostrano affiancati il valore predefinito con smorzamento critico e la variante di rimbalzo del momentum.
  • Un helper project() che implementa la proiezione del momentum con decelerationRate impostato di default a 0.998.
  • CSS per trasparenza ridotta che sostituisce le barre degli strumenti translucide con sfondi solidi e senza sfocatura.
Vedi l'esempio di prompt ↗

Come funziona

  1. 01
    Rispondere al pointer-down

    Il feedback appartiene alla pressione, non al rilascio: evidenziare il controllo nell'istante in cui viene premuto, e considerare qualsiasi elemento non essenziale sul percorso di input, incluso il ritardo di tocco di circa 300ms, come una regressione.

  2. 02
    Seguire il Pointer 1:1

    Utilizzare i Pointer Events con capture, così il tracking sopravvive anche quando il puntatore esce dai limiti dell'elemento, e rispettare il punto in cui l'utente ha afferrato l'elemento invece di far scattare tutto al centro dell'elemento.

  3. 03
    Rendere il Movimento Interrompibile

    Un elemento in movimento deve poter essere afferrato e invertito a metà del volo; l'utente non dovrebbe mai dover attendere che l'animazione in corso termini prima di reindirizzarla.

  4. 04
    Modellare il Movimento con le Spring

    Una spring assorbe il nuovo input semplicemente cambiando il suo target, così il movimento resta continuo; gli script a durata fissa non hanno nulla da ri-mirare.

  5. 05
    Trasferire la Velocità di Rilascio

    Fornire alla spring la velocità del puntatore al momento del rilascio, così non c'è alcuna cesura tra il drag e l'animazione; normalizzare in base alla distanza rimanente quando l'API richiede una velocità relativa.

  6. 06
    Proiettare l'Inerzia, Poi Agganciare

    Non agganciare dal punto esatto in cui il dito ha lasciato la presa; proiettare la posizione di riposo come farebbe la decelerazione dello scroll e scegliere il target di aggancio più vicino a quella proiezione.

02 Trova la tua applicazione

Quando Usare lo Skill apple-design

Usa lo skill apple-design in Claude Code o Codex quando il lavoro è ricerca UX di questo tipo. Ambito e limiti qui sotto sono presi dal file dello skill stesso.

Buona applicazione

  • Costruzione o revisione di UI basate su gesture come drag, swipe, sheet, momentum e transizioni interrompibili.
  • Lavoro su materiali translucidi e profondità, dove nav bar, toolbar e sheet fungono da livello funzionale fluttuante.
  • Lavoro tipografico su scala dimensionale, dove optical sizing, tracking e leading devono variare con la dimensione.
  • Passaggi di accessibilità in cui movimento ridotto, trasparenza ridotta e contrasto aumentato sono integrati nei componenti invece di essere aggiunti in un secondo momento.
  • Team che vogliono i principi di design di Apple come vocabolario condiviso esplicito quando si discute una decisione.

Conosci i limiti

  • Animazione pre-scriptata o a durata fissa, che la skill esclude non appena l'utente può toccare l'elemento.
  • Recognizer che riportano solo lo stato finale di una gesture, perché scartano il tracking continuo da cui dipende il feedback.
  • Chrome opaco che occupa una fascia fissa invece di lasciare che il contenuto scorra sotto un livello translucido.
  • Le conferme come abitudine predefinita; il file le riserva solo alle azioni realmente distruttive e irreversibili.

Cosa fornire

  • Il codice della gesture e la sua cronologia del puntatorePortare l'implementazione dei Pointer Events, poiché la skill si aspetta setPointerCapture e una breve cronologia di velocità/posizione, non solo il punto attuale.
  • Una libreria di spring che ri-mira la velocitàIl mapping web passa attraverso Motion / Framer Motion, e la libreria deve trasportare la velocità attraverso un ri-mirino; non tutte le implementazioni di spring lo fanno.
  • Il chrome translucido che si desidera far revisionareToolbar, nav bar e sheet sono costruiti come livelli translucidi con blur backdrop-filter e uno sfondo semi-trasparente, con il contenuto che scorre sotto di essi.

03 Dentro la skill

Regole che la Skill apple-design Dà a Claude Code e Codex

8 istruzioni concrete, valori predefiniti e limiti che il SKILL.md imposta per l'agente — la parte del file che cambia il risultato.

  1. Predefinire una Spring con Damping Critico

    Impostare la maggior parte della UI a damping 1.0 così si assesta senza overshoot; aggiungere un bounce, intorno a damping 0.8, solo dove la gesture stessa ha portato momentum, come un flick o un rilascio da drag.

  2. Anima a partire dal valore di presentazione

    All'interruzione, leggi la trasformazione live sullo schermo dell'elemento e avvia la nuova animazione da lì; partire dal valore logico o dal valore di destinazione produce un salto visibile.

  3. Non guidare i gesti con le transizioni CSS

    Le transizioni CSS e i @keyframes non possono essere afferrati e invertiti in modo fluido a metà del movimento, quindi il movimento guidato dai gesti deve essere gestito da una libreria di spring.

  4. Suddividi il movimento 2D in due spring

    Esegui spring X e Y indipendenti invece di un unico spring su una distanza 2D, perché gli assi si desincronizzano quando le loro velocità differiscono.

  5. Usa la proiezione di Apple, non quella dei manuali

    La formula da manuale di fisica v²/(2·decel) non è quella usata da Apple; usa la forma a decadimento esponenziale con decelerationRate 0.998 per una sensazione di scroll normale, o 0.99 per qualcosa di più scattante.

  6. Fondi la velocità durante un'inversione

    Sostituire un'animazione con un'altra nel momento in cui un gesto si inverte crea una discontinuità di velocità, un muro; scegli una libreria di spring che riorienti il target a partire dalla velocità attuale.

  7. Non sovrapporre mai superfici traslucide chiare

    Il peso del materiale è il modo in cui si legge la gerarchia: i materiali più pesanti separano le regioni strutturali e quelli più leggeri evidenziano gli elementi interattivi, quindi non sovrapporre livelli traslucidi chiari tra loro.

  8. Non usare mai un unico valore di tracking per tutte le dimensioni

    La spaziatura tra lettere è specifica per dimensione: il testo display grande vuole un tracking negativo mentre il testo piccolo vuole un tracking leggermente positivo, quindi una spaziatura fissa risulterà sbagliata da qualche parte.

04 Mettila al lavoro

Installare apple-design in Claude Code o Codex

Un comando npx skills add, poi un primo task nel tuo agente e una checklist per il risultato.

Aggiungere apple-design a Claude Code, Codex o al Tuo Agente

Eseguitelo nel Suo progetto; l'installer chiede a quale agente aggiungerlo.

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

Forma generica del comando CLI skills per skills/apple-design/SKILL.md; il repository potrebbe documentare un proprio percorso.

Assegnare allo Skill un Primo Compito di Ricerca UX

Redatto nei termini propri della skill; sostituisca le parti tra parentesi con il suo materiale.

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: redatto a partire dal SKILL.md, nei termini propri della skill.

Verifica il primo risultato

Ciò che il SKILL.md stesso indica come risultato corretto:

  • Afferra di nuovo un elemento in chiusura a metà del movimento e verifica che segua il dito invece di completare prima la sua chiusura.
  • Inverti un gesto e osserva se c'è una discontinuità di velocità, il che significa che la velocità non è stata fusa attraverso il ri-orientamento del target.
  • Fai test con persone reali in un contesto reale, poiché il giudizio sul movimento non è attendibile sulla macchina di uno sviluppatore.
  • Riproduci il movimento a velocità ridotta o fotogramma per fotogramma, perché i difetti interessanti sono invisibili a velocità normale.
  • Verifica che il punto di arrivo derivi dal punto finale proiettato e non dal punto di rilascio.
  • Controlla la variante a trasparenza ridotta: le superfici traslucide dovrebbero diventare più opache o solide, con l'opacità dello sfondo aumentata e la sfocatura ridotta.

In OpenDesign importa apple-design dal suo link SKILL.md: Plugins → Add → Skill → Import from link, poi selezionalo nella barra superiore.

05 Open source, tracciabile

Sorgente, licenza e verifica

Da dove provengono i dati di questa pagina e quando sono stati verificati l'ultima volta.

Repository
github.com/emilkowalski/skills Branch main
File della skill
skills/apple-design/SKILL.md Checksum del contenuto registrato alla verifica; commit d23d7f8
License
MIT Da LICENSE.
Stelle del repository
37.516 Snapshot GitHub acquisito il 2026-09-14 per l'intero repository emilkowalski/skills, che contiene 9 skill in questo catalogo. Non è una valutazione o un conteggio di utilizzo per apple-design.
Verificato da OpenDesign
14/09/2026 File sorgente, percorso, testo della licenza e conteggio delle stelle sono stati verificati. Non inclusa in OpenDesign main (verificato il 28/08/2026); un'esecuzione live non è stata registrata in questa pagina.

All'interno di SKILL.md

  1. 1. Risposta — elimina la latenzaRispondi al pointer-down, verifica ogni latenza, mantieni un feedback continuo durante tutta l'interazione.
  2. 2. Manipolazione diretta — tracking 1:1Vincola il contenuto al puntatore, rispetta l'offset di presa, mantieni una breve cronologia della velocità.
  3. 3. Interrompibilità — il principio singolo più importanteNon bloccare mai l'input, animare dal valore di presentazione, unire la velocità in caso di inversione, suddividere le molle 2D.
  4. 4. Comportamento oltre l'animazione — utilizzare le molleIl rapporto di smorzamento e la risposta sostituiscono la fisica; smorzamento 1.0 predefinito, rimbalzo solo per il momentum.
  5. 5. Passaggio di velocità — la giuntura tra trascinamento e animazionePassare la velocità di rilascio alla molla, normalizzando in base alla distanza residua quando necessario
Descrizione della skill
"L'approccio di Apple al design di interfacce e al movimento fluido e fisico, tradotto per il web. Da usare quando costruisci o rivedi UI guidate da gesti, animazioni a molla, interazioni drag/swipe/sheet, transizioni con momentum e interrompibili, materiali traslucidi e profondità, tipografia (dimensionamento ottico, spaziatura, interlinea), reduced-motion, o le fondamenta di design (feedback, coerenza spaziale, sobrietà) dietro le interfacce in stile Apple."

Descrizione front-matter da SKILL.md. Il file completo è di circa 22.559 caratteri. Leggi il file completo su GitHub.

Apple Design

Esegui apple-design su un compito reale di ricerca UX.

Scarica OpenDesign, importa apple-design dal suo link SKILL.md, incolla il prompt qui sopra e leggi il piano prima del risultato.

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

OpenDesign Desktop

Un solo design system. Il tuo brand, coerente ovunque

Nel Vibe Design Workspace completo, applica le stesse regole di brand a siti, presentazioni, prototipi interattivi, dashboard, immagini e video HTML. Collega Codex, Claude Code, Cursor e gli altri agenti di coding locali e crea gratis.

  • Siti, presentazioni, prototipi, dashboard, immagini e video
  • Oltre 140 design system e la libreria completa di template e skill
  • Codex locale e oltre 21 agenti di coding · Gratis
Scarica gratis

Disponibile per macOS e Windows