Communitygithub.com

모션 성능 수정

UI 애니메이션 성능 문제를 진단하고 수정합니다.

모션 성능 수정란 무엇인가요?

이 스킬은 CSS, WAAPI, Motion, rAF, GSAP 등 다양한 애니메이션 시스템에서 성능 저하를 유발하는 패턴을 식별하고 수정하는 방법을 제공합니다. 레이아웃, 페인트, 합성(composite)의 렌더링 단계별 비용을 이해하고, 'never patterns'부터 'tool boundaries'까지 9가지 우선순위 범주로 체계적인 규칙을 적용합니다. Claude Code, Cursor 등 AI 어시스턴트와 함께 사용할 수 있으며, 특정 파일을 지정하면 해당 파일의 애니메이션 코드를 검토하여 위반 사항, 중요성, 구체적인 수정 제안을 보고합니다. 기존 애니메이션 라이브러리를 마이그레이션하지 않고, 현재 스택 내에서 규칙을 적용하는 것을 원칙으로 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/ibelick/fixing-motion-performance

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

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

문서

모션 성능 수정은(는) 무엇을 하나요?

애니메이션 성능 문제를 수정합니다.

사용 방법

  • /fixing-motion-performance 이 대화의 모든 UI 애니메이션 작업에 아래 규칙을 적용합니다.

  • /fixing-motion-performance <파일> 파일을 모든 규칙에 대해 검토하고 다음을 보고합니다:

    • 위반 사항 (정확한 줄 또는 코드 조각 인용)
    • 중요성 (짧은 문장 하나)
    • 구체적인 수정 (코드 수준 제안)

명시적으로 요청하지 않는 한 애니메이션 라이브러리를 마이그레이션하지 마세요. 현재 스택 내에서 규칙을 적용합니다.

적용 시기

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

  • UI 애니메이션 추가 또는 변경 (CSS, WAAPI, Motion, rAF, GSAP)
  • 끊기거나 느린 상호작용 또는 전환 리팩토링
  • 스크롤 연동 모션 또는 스크롤 시 표시(reveal-on-scroll) 구현
  • 레이아웃, 필터, 마스크, 그라디언트 또는 CSS 변수 애니메이션
  • will-change, transform 또는 측정(measurement)을 사용하는 컴포넌트 검토

렌더링 단계 용어 설명

  • 합성(composite): transform, opacity
  • 페인트(paint): color, borders, gradients, masks, images, filters
  • 레이아웃(layout): size, position, flow, grid, flex

우선순위별 규칙 범주

우선순위범주영향
1금지 패턴심각
2메커니즘 선택심각
3측정높음
4스크롤높음
5페인트중간-높음
6레이어중간
7블러 및 필터중간
8뷰 전환낮음
9도구 경계심각

빠른 참조

1. 금지 패턴 (심각)

  • 같은 프레임에서 레이아웃 읽기와 쓰기를 섞지 마세요
  • 크거나 중요한 표면에서 레이아웃을 지속적으로 애니메이션하지 마세요
  • scrollTop, scrollY 또는 scroll 이벤트로 애니메이션을 구동하지 마세요
  • 중지 조건 없는 requestAnimationFrame 루프를 사용하지 마세요
  • 각각 레이아웃을 측정하거나 변경하는 여러 애니메이션 시스템을 혼합하지 마세요

2. 메커니즘 선택 (심각)

  • 모션에는 transform과 opacity를 기본으로 사용하세요
  • 상호작용이 필요한 경우에만 JS 기반 애니메이션을 사용하세요
  • 페인트 또는 레이아웃 애니메이션은 작고 독립된 표면에서만 허용됩니다
  • 일회성 효과는 지속적인 모션보다 더 자주 허용됩니다
  • 모션을 완전히 제거하는 것보다 기술 수준을 낮추는 것을 선호하세요

3. 측정 (높음)

  • 한 번 측정한 후 transform 또는 opacity로 애니메이션하세요
  • 모든 DOM 읽기를 쓰기 전에 일괄 처리하세요
  • 애니메이션 중에 레이아웃을 반복해서 읽지 마세요
  • 레이아웃 효과에는 FLIP 스타일 전환을 선호하세요
  • 측정과 쓰기를 일괄 처리하는 접근 방식을 선호하세요

4. 스크롤 (높음)

  • 스크롤 연동 모션에는 Scroll 또는 View Timelines을 사용하세요 (가능한 경우)
  • 가시성 및 일시 중지에는 IntersectionObserver를 사용하세요
  • 애니메이션을 위해 스크롤 위치를 폴링하지 마세요
  • 화면 밖에서는 애니메이션을 일시 중지하거나 중지하세요
  • 스크롤 연동 모션은 큰 표면에서 지속적인 레이아웃이나 페인트를 유발해서는 안 됩니다

5. 페인트 (중간-높음)

  • 페인트를 유발하는 애니메이션은 작고 독립된 요소에만 허용됩니다
  • 큰 컨테이너에서 페인트 비용이 많이 드는 속성을 애니메이션하지 마세요
  • transform, opacity 또는 position을 위해 CSS 변수를 애니메이션하지 마세요
  • 상속된 CSS 변수를 애니메이션하지 마세요
  • 애니메이션되는 CSS 변수는 로컬 범위로 지정하고 상속을 피하세요

6. 레이어 (중간)

  • 합성기(compositor) 모션에는 레이어 승격이 필요하며, 자동으로 가정하지 마세요
  • will-change는 일시적이고 필요한 부분에만 사용하세요
  • 많거나 큰 승격된 레이어를 피하세요
  • 성능이 중요한 경우 도구를 사용하여 레이어 동작을 검증하세요

7. 블러 및 필터 (중간)

  • 블러 애니메이션은 작게 유지하세요 (<=8px)
  • 블러는 짧고 일회성 효과에만 사용하세요
  • 블러를 지속적으로 애니메이션하지 마세요
  • 큰 표면에서 블러를 애니메이션하지 마세요
  • 블러보다 opacity와 translate를 먼저 고려하세요

8. 뷰 전환 (낮음)

  • 뷰 전환은 내비게이션 수준 변경에만 사용하세요
  • 상호작용이 많은 UI에서는 뷰 전환을 피하세요
  • 중단 또는 취소가 필요한 경우 뷰 전환을 피하세요
  • 크기 변경은 잠재적으로 레이아웃을 유발할 수 있으므로 주의하세요

9. 도구 경계 (심각)

  • 명시적으로 요청하지 않는 한 애니메이션 라이브러리를 마이그레이션하거나 다시 작성하지 마세요
  • 기존 애니메이션 시스템 내에서 이 규칙을 적용하세요
  • 동일한 컴포넌트 내에서 API를 부분적으로 마이그레이션하거나 스타일을 혼합하지 마세요

검토 지침

  • 심각한 규칙부터 적용하세요 (금지 패턴, 도구 경계)
  • 의도와 일치하는 가장 비용이 적게 드는 렌더링 작업을 선택하세요
  • 기본값이 아닌 선택을 하는 경우, 이를 정당화하는 제약 조건 (표면 크기, 지속 시간 또는 상호작용 요구 사항)을 명시하세요
  • 검토 시 이론보다는 실행 가능한 메모와 구체적인 대안을 선호하세요

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

관련 스킬