Communitygithub.com

ComeOnOliver/skillshub

SwiftUI iOS 26 / Swift 6.2 앱을 위한 독단적이고 엄격한 애니메이션 제작 가이드입니다. 8개 카테고리에 걸쳐 50개의 규칙을 포함하며, Airbnb 엔지니어링 모션 패턴, Apple WWDC 세션 및 Apple Human Interface Guidelines에서 파생되었습니다.

skillshub란 무엇인가요?

이 스킬은 SwiftUI iOS 26 및 Swift 6.2를 사용하는 애플리케이션을 위한 엄격하고 종합적인 애니메이션 제작 가이드를 제공합니다. Airbnb 엔지니어링 모션 패턴, Apple WWDC 세션, Apple 휴먼 인터페이스 가이드라인에서 파생된 50개의 규칙을 8개의 우선순위 카테고리로 구성하여 성능, 접근성 및 아키텍처 규정 준수를 보장합니다. 이 스킬은 모든 애니메이션 뷰에 @Equatable 매크로 사용, 모든 스프링/타이밍 값에 모션 토큰 사용, 레이아웃에 디자인 시스템 토큰 사용을 의무화하여 일관성과 유지보수성을 크게 향상시킵니다. Claude Code, Cursor와 같은 AI 에이전트와 함께 사용하도록 설계되었으며, 'swift-ui-architect' 및 'ios-design-system'과 같은 형제 스킬과 함께 작동하여 완전한 모듈식 MVVM-C 아키텍처를 제공합니다. 각 규칙은 상세한 설명과 올바른/잘못된 코드 예제를 포함한 개별 참조 파일에 문서화되어 있어 SwiftUI 애니메이션에 대한 실용적인 지침을 제공합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

dot-skills — Airbnb iOS SwiftUI 애니메이션 모범 사례

SwiftUI iOS 26 / Swift 6.2 앱을 위한 독단적이고 엄격한 애니메이션 제작 가이드입니다. 8개 카테고리에 걸쳐 50개의 규칙을 포함하며, Airbnb 엔지니어링 모션 패턴, Apple WWDC 세션 및 Apple Human Interface Guidelines에서 파생되었습니다. 모든 애니메이션 뷰에 @Equatable, 모든 스프링/타이밍 값에 모션 토큰, 레이아웃에 디자인 시스템 토큰을 의무화합니다.

필수 아키텍처 정렬

이 스킬은 swift-ui-architect 및 ios-design-system과 함께 작동하도록 설계되었습니다. 모든 코드 예제는 다음과 같은 동일한 절대적 제약 조건을 따릅니다:

  • 모든 뷰에 @Equatable 매크로 사용 (Airbnb는 스크롤 히치 15% 감소 측정)
  • 비즈니스 로직 트리거를 포함하는 복잡한 애니메이션 상태에 @Observable 사용
  • 뷰 소유 애니메이션 상태 (토글 부울, 드래그 오프셋)에 @State 사용
  • 디자인 시스템 토큰: Spacing.xs/sm/md/lg, Radius.sm/md/lg — 하드코딩된 레이아웃 숫자 없음
  • 모션 토큰: Motion.standard/responsive/playful — 흩어져 있는 스프링 리터럴 없음
  • 시맨틱 색상: .backgroundSurface, .accentPrimary — 뷰에 원시 Color 리터럴 없음
  • 기능 애니메이션은 프레젠테이션 전용으로 유지; 데이터/네트워크 관련 사항은 Data 패키지에 유지

범위 및 형제 스킬과의 관계

이 스킬은 모션 레이어입니다 — 유동적이고 성능이 뛰어난 애니메이션을 구축하는 방법을 가르칩니다. 형제 스킬과 함께 로드될 때:

형제 스킬초점이 스킬의 초점
swift-ui-architect아키텍처 (모듈식 MVVM-C, 라우트 셸, 프로토콜 경계)애니메이션 아키텍처 (모션 토큰, 스프링 선택, 오케스트레이션)
ios-design-system디자인 시스템 인프라 (토큰, 스타일, 거버넌스)모션 토큰 및 애니메이션 컴포넌트 패턴
ios-higHIG 준수 패턴모션 특정 HIG (모션 감소, 공간적 연속성)

범위 외: 디자이너가 작성한 벡터 애니메이션 (Lottie를 After Effects 내보내기에 사용). 복잡한 UIKit 전환 컨트롤러 (Airbnb의 선언적 전환 프레임워크 참조). 이 스킬은 프로그래매틱 SwiftUI 애니메이션만 다룹니다.

클리닉 아키텍처 계약 (iOS 26 / Swift 6.2)

이 스킬의 모든 지침은 클리닉 모듈식 MVVM-C 아키텍처를 가정합니다:

  • 기능 모듈은 Domain + DesignSystem만 임포트합니다 (Data 또는 형제 기능은 절대 임포트하지 않음)
  • App 타겟은 수렴 지점이며 DependencyContainer, 구체적인 코디네이터 및 Route Shell 배선을 소유합니다
  • Domain은 순수 Swift로 유지되며 모델, 리포지토리, *Coordinating, ErrorRouting 및 AppError 계약을 정의합니다
  • Data는 SwiftData/네트워크/동기화/재시도/백그라운드 I/O를 소유하고 Domain 프로토콜을 구현합니다
  • 읽기/쓰기 흐름은 기본적으로 stale-while-revalidate 읽기 및 낙관적 큐 쓰기를 사용합니다
  • ViewModel은 리포지토리 프로토콜을 직접 호출합니다 (기본 use-case/interactor 레이어 없음)

적용 시기

다음과 같은 경우 이 지침을 참조하세요:

  • SwiftUI 뷰 또는 전환에 애니메이션 추가
  • 제스처 기반 상호작용 구축 (드래그, 스와이프, 팬)
  • 공간 전환 (확장/축소, 탐색 변형)으로 뷰 연결
  • 마이크로 상호작용 디자인 (버튼 누름, 토글, 로딩 상태)
  • 콘텐츠 변경을 물리적으로 느껴지도록 만들기 (숫자 롤, 심볼 교체)
  • 다중 요소 애니메이션 시퀀스 안무 (KeyframeAnimator, PhaseAnimator)
  • 디자인 시스템을 위한 모션 토큰 정의
  • 성능, 접근성 및 아키텍처 규정 준수를 위한 애니메이션 코드 검토

우선순위별 규칙 카테고리

우선순위카테고리영향접두사규칙 수
1스프링 물리치명적spring-8
2타이밍 & 느낌치명적feel-6
3제스처 연속성높음gesture-7
4공간 전환높음spatial-6
5마이크로 상호작용높음micro-6
6오케스트레이션높음orch-5
7공예 & 광택높음craft-5
8콘텐츠 모션중간-높음content-5

빠른 참조

1. 스프링 물리 (치명적)

2. 타이밍 & 느낌 (치명적)

3. 제스처 연속성 (높음)

4. 공간 전환 (높음)

5. 마이크로 상호작용 (높음)

6. 오케스트레이션 (높음)

7. 공예 & 광택 (높음)

8. 콘텐츠 모션 (중간-높음)

사용 방법

올바른/잘못된 코드 예제가 포함된 자세한 설명은 개별 참조 파일을 읽으세요:

참조 파일

파일설명
references/_sections.md카테고리 정의 및 순서
assets/templates/_template.md새 규칙을 위한 템플릿
metadata.json버전 및 참조 정보

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

관련 스킬