Communitygithub.com

ComeOnOliver/skillshub

Guide rigoureux et opinioné pour l'animation SwiftUI sous iOS 26 / Swift 6.2. Contient 50 règles réparties en 8 catégories, priorisées par impact. Issues des patterns de mouvement d'Airbnb Engineering, des sessions Apple WWDC et des Human Interface Guidelines d'Apple. Exige @Equatable sur chaque vue animée, des jetons de mouvement pour toutes les valeurs de ressort/timing, et des jetons du système de conception pour la mise en page.

Qu'est-ce que skillshub ?

Ce skill fournit un guide d'architecture d'animation strict et opinioné pour les applications SwiftUI ciblant iOS 26 et Swift 6.2. Il s'inspire des meilleures pratiques d'Airbnb en matière de motion design, des sessions WWDC d'Apple et des Human Interface Guidelines d'Apple. Le skill impose des règles précises : l'utilisation systématique de la macro `@Equatable` sur chaque vue animée pour réduire le scintillement, l'emploi de jetons de mouvement (`Motion.standard/responsive/playful`) pour toutes les animations par ressort ou timing, et le recours à des jetons du système de conception (`Spacing.sm/md/lg`, `Radius.sm/md/lg`) plutôt qu'à des valeurs codées en dur. Il couvre 8 catégories de règles classées par priorité critique ou élevée : physique des ressorts, timing et ressenti, continuité gestuelle, transitions spatiales, micro-interactions, orchestration, finition et polissage, et mouvement de contenu. Ce skill est conçu pour fonctionner de concert avec les skills `swift-ui-architect` et `ios-design-system`. Il est destiné aux développeurs d'agents IA et aux ingénieurs qui souhaitent créer des animations performantes, accessibles et conformes à l'architecture modulaire MVVM-C. L'implémentation de ces règles permet d'éviter les erreurs courantes (sauts de layout, animations saccadées) et de produire une expérience utilisateur fluide et professionnelle.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/pproenca/dot-skills/ios-animations

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

dot-skills — Bonnes pratiques d'animations SwiftUI pour Airbnb iOS

Guide rigoureux et opinioné pour l'animation SwiftUI sous iOS 26 / Swift 6.2. Contient 50 règles réparties en 8 catégories, priorisées par impact. Issues des patterns de mouvement d'Airbnb Engineering, des sessions Apple WWDC et des Human Interface Guidelines d'Apple. Exige @Equatable sur chaque vue animée, des jetons de mouvement pour toutes les valeurs de ressort/timing, et des jetons du système de conception pour la mise en page.

Alignement architectural imposé

Ce skill est conçu pour fonctionner avec swift-ui-architect et ios-design-system. Tous les exemples de code suivent les mêmes contraintes non négociables :

  • Macro @Equatable sur chaque vue (Airbnb a mesuré une réduction de 15 % du scintillement de défilement)
  • @Observable pour les états d'animation complexes impliquant des déclencheurs métier
  • @State pour les états d'animation appartenant à la vue (booléens de bascule, décalages de glissement)
  • Jetons du système de conception : Spacing.xs/sm/md/lg, Radius.sm/md/lg — zéro nombre de mise en page codé en dur
  • Jetons de mouvement : Motion.standard/responsive/playful — zéro littéral de ressort dispersé
  • Couleurs sémantiques : .backgroundSurface, .accentPrimary — aucun littéral Color brut dans les vues
  • Les animations de fonctionnalités restent purement de présentation ; les préoccupations de données/réseau restent dans le package Data

Portée et relation avec les skills frères

Ce skill constitue la couche de mouvement — il enseigne comment CONSTRUIRE des animations fluides et performantes. Lorsqu'il est chargé avec les skills frères :

Skill frèreSon objectifL'objectif de ce skill
swift-ui-architectArchitecture (MVVM-C modulaire, coquilles de routes, frontières de protocoles)Architecture d'animation (jetons de mouvement, sélection de ressorts, orchestration)
ios-design-systemInfrastructure du système de conception (jetons, styles, gouvernance)Jetons de mouvement et motifs de composants animés
ios-higConformité HIG patternsHIG spécifique au mouvement (réduire le mouvement, continuité spatiale)

Hors de portée : Animations vectorielles conçues par des designers (utilisez Lottie pour les exports After Effects). Contrôleurs de transition UIKit complexes (voir le framework de transition déclarative d'Airbnb). Ce skill couvre uniquement les animations SwiftUI programmatiques.

Contrat d'architecture clinic (iOS 26 / Swift 6.2)

Tous les conseils de ce skill supposent l'architecture clinic modulaire MVVM-C :

  • Les modules de fonctionnalités importent uniquement Domain + DesignSystem (jamais Data, jamais les fonctionnalités frères)
  • La cible App est le point de convergence et possède DependencyContainer, les coordinateurs concrets et le câblage de Route Shell
  • Domain reste du Swift pur et définit les modèles plus les contrats des dépôts, *Coordinating, ErrorRouting et AppError
  • Data possède SwiftData/réseau/synchronisation/réessai/E/S en arrière-plan et implémente les protocoles Domain
  • Le flux de lecture/écriture par défaut utilise des lectures stale-while-revalidate et des écritures optimistes en file d'attente
  • Les ViewModels appellent directement les protocoles de dépôt (pas de couche use-case/interactor par défaut)

Quand appliquer

Référez-vous à ces directives lorsque :

  • Vous ajoutez des animations aux vues ou transitions SwiftUI
  • Vous créez des interactions basées sur des gestes (glissement, balayage, panoramique)
  • Vous connectez des vues avec des transitions spatiales (agrandissement/réduction, morphing de navigation)
  • Vous concevez des micro-interactions (pression de bouton, bascule, états de chargement)
  • Vous rendez les changements de contenu physiques (rouleaux de nombres, remplacements de symboles)
  • Vous chorégraphiez des séquences d'animation multi-éléments (KeyframeAnimator, PhaseAnimator)
  • Vous définissez des jetons de mouvement pour un système de conception
  • Vous révisez du code d'animation pour la performance, l'accessibilité et la conformité architecturale

Catégories de règles par priorité

PrioritéCatégorieImpactPréfixeRègles
1Physique des ressortsCRITIQUEspring-8
2Timing et ressentiCRITIQUEfeel-6
3Continuité gestuelleÉLEVÉgesture-7
4Transitions spatialesÉLEVÉspatial-6
5Micro-interactionsÉLEVÉmicro-6
6OrchestrationÉLEVÉorch-5
7Finition et polissageÉLEVÉcraft-5
8Mouvement de contenuMOYEN-ÉLEVÉcontent-5

Référence rapide

1. Physique des ressorts (CRITIQUE)

2. Timing et ressenti (CRITIQUE)

3. Continuité gestuelle (ÉLEVÉ)

4. Transitions spatiales (ÉLEVÉ)

5. Micro-interactions (ÉLEVÉ)

6. Orchestration (ÉLEVÉ)

7. Finition et polissage (ÉLEVÉ)

  • craft-reduce-motion — Respecter accessibilityReduceMotion avec un repli de fondu enchaîné
  • craft-blur-bridge — Utiliser le flou pour combler les états de transition imparfaits
  • craft-drawing-group — Utiliser drawingGroup() pour les animations complexes supportées par Metal
  • craft-geometry-group — Utiliser geometryGroup() pour isoler la propagation de l'animation de mise en page
  • craft-transaction-debug — Utiliser Transaction pour déboguer et outrepasser le comportement d'animation

8. Mouvement de contenu (MOYEN-ÉLEVÉ)

Comment utiliser

Lisez les fichiers de référence individuels pour des explications détaillées avec des exemples de code corrects/incorrects :

Fichiers de référence

FichierDescription
references/_sections.mdDéfinitions et ordre des catégories
assets/templates/_template.mdModèle pour les nouvelles règles
metadata.jsonInformations de version et de référence

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés