Communitygithub.com

ASoudy/AGS

레이아웃 스래싱, 컴포지터 속성, 스크롤 연동 모션, 블러 효과 등 애니메이션 성능 문제를 감사하고 수정합니다. 애니메이션이 끊기거나, 전환이 버벅이거나, CSS/JS 애니메이션 성능을 검토할 때 사용하세요.

AGS란 무엇인가요?

이 스킬은 UI 애니메이션의 성능 문제를 진단하고 수정하기 위한 포괄적인 가이드라인을 제공합니다. 레이아웃 스래싱, 컴포지터 속성, 스크롤 연동 모션, 블러 효과 등 다양한 애니메이션 관련 성능 저하 원인을 식별하고 구체적인 해결책을 제시합니다. CSS, WAAPI, Motion, rAF, GSAP 등 여러 애니메이션 스택을 지원하며, 애니메이션을 추가하거나, 버벅거리는 상호작용을 리팩토링하거나, 스크롤 연동 모션을 구현하는 상황에서 특히 유용합니다. 우선순위가 매겨진 규칙(절대 패턴, 메커니즘 선택, 측정, 스크롤, 페인트, 레이어, 블러 및 필터, 뷰 전환, 도구 경계)을 통해 개발자가 가장 영향력 있는 개선 사항부터 집중적으로 처리할 수 있도록 안내합니다. 주요 해결책으로는 transform과 opacity를 기본 모션으로 사용하고, FLIP 기법을 적용하며, 스크롤 기반 애니메이션에 Scroll Timelines을 활용하는 방법을 강조합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/fixing-motion-performance

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

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

문서

모션 성능 수정하기

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

사용 방법

  • /모션-성능-수정 이 대화에서 UI 애니메이션 작업에 다음 제약 조건을 적용합니다.

  • /모션-성능-수정 <파일> 아래의 모든 규칙에 대해 파일을 검토하고 다음을 보고합니다:

    • 위반 사항(정확한 줄 또는 코드 조각을 인용)
    • 그 이유(한 문장으로 간결하게)
    • 구체적인 수정 방법(코드 수준 제안)

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

사용 시기

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

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

렌더링 단계 용어집

  • 컴포지트(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 또는 스크롤 이벤트로 애니메이션을 구동하지 마세요
  • 정지 조건이 없는 requestAnimationFrame 루프는 사용하지 마세요
  • 각각 레이아웃을 측정하거나 변경하는 여러 애니메이션 시스템을 혼합하지 마세요

2. 메커니즘 선택 (치명적)

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

3. 측정 (높음)

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

4. 스크롤 (높음)

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

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

  • 페인트를 유발하는 애니메이션은 작고 격리된 요소에만 허용됩니다
  • 큰 컨테이너에서 페인트 부하가 큰 속성을 애니메이션하지 마세요
  • transform, opacity 또는 위치를 위해 CSS 변수를 애니메이션하지 마세요
  • 상속된 CSS 변수를 애니메이션하지 마세요
  • 애니메이션되는 CSS 변수의 범위를 지역적으로 제한하고 상속을 피하세요

6. 레이어 (중간)

  • 컴포지터 모션은 레이어 승격이 필요하며, 절대 가정하지 마세요
  • will-change를 일시적이고 선택적으로 사용하세요
  • 많거나 큰 승격된 레이어를 피하세요
  • 성능이 중요할 때는 도구를 사용하여 레이어 동작을 검증하세요

7. 블러 및 필터 (중간)

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

8. 뷰 전환 (낮음)

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

9. 도구 경계 (치명적)

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

일반적인 수정 방법

/* 레이아웃 스래싱: width 대신 transform을 애니메이션 */
/* 이전 */ .panel { transition: width 0.3s; }
/* 이후 */  .panel { transition: transform 0.3s; }

/* 스크롤 연동: JS 대신 scroll-timeline 사용 */
/* 이전 */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* 이후 */  .reveal { animation: fade-in linear; animation-timeline: view(); }
// 측정: 쓰기 전에 읽기를 배치(FLIP)
// 이전 — 레이아웃 스래싱
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// 이후 — 한 번 측정하고 transform으로 애니메이션
const first = el.getBoundingClientRect();
el.classList.add('moved');
const last = el.getBoundingClientRect();
el.style.transform = `translateX(${first.left - last.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });

검토 지침

  • 먼저 치명적인 규칙(절대 패턴, 도구 경계)을 적용하세요
  • 의도에 가장 부합하면서 렌더링 작업이 가장 적은 방법을 선택하세요
  • 기본값이 아닌 선택을 하는 경우, 이를 정당화하는 제약 조건(표면 크기, 지속 시간 또는 상호작용 요구 사항)을 명시하세요
  • 검토할 때는 이론보다 실행 가능한 메모와 구체적인 대안을 선호하세요

제한 사항

  • 이 스킬은 작업이 위에서 설명한 범위에 명확히 해당할 때만 사용하세요.
  • 이 출력을 환경별 검증, 테스트 또는 전문가 검토를 대체하는 것으로 간주하지 마세요.
  • 필요한 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 멈추고 명확히 질문하세요.

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

관련 스킬