Communitygithub.com

Anhvu1107/모든-에이전트-스킬

요청이 '모션 성능 수정'과 일치할 때 항상 사용: 레이아웃 쓰레싱, 컴포지터 속성, 스크롤 연계 모션, 블러 효과 등 애니메이션 성능 문제를 감사하고 수정합니다.

모든-에이전트-스킬란 무엇인가요?

이 스킬은 UI 애니메이션 성능 문제를 진단하고 수정하기 위한 포괄적인 가이드라인 세트입니다. 레이아웃 쓰레싱(layout thrashing), 컴포지터(compositor) 속성 오용, 스크롤 연계 모션(scroll-linked motion), 블러 효과 등의 일반적인 성능 저하 원인을 체계적으로 분석하고 해결책을 제시합니다. CSS, WAAPI, Motion, rAF, GSAP 등 다양한 애니메이션 시스템을 지원하며, 크롬, 파이어폭스, 사파리 등 주요 브라우저에서 동작합니다. 9가지 우선순위 기반 규칙(never 패턴, 메커니즘 선택, 측정, 스크롤, 페인트, 레이어, 블러/필터, 뷰 전환, 도구 경계)을 제공하여 개발자가 단계적으로 성능을 개선할 수 있도록 돕습니다. 특히 FLIP 기법과 Scroll/View Timelines 같은 최신 API를 활용한 구체적인 코드 수정 예시를 포함하여 실무에 바로 적용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Anhvu1107/all-agent-skill/tree/HEAD/.agent/skills/fixing-motion-performance

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

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

문서

모션 성능 수정 (fixing-motion-performance)

선택적 읽기 규칙

다음부터 시작하세요:

  • references/senior-master-standard.md
  • references/usage-routing.md
  • references/quality-checklist.md

그런 다음 사용자의 실제 작업과 일치하는 상속된 문서, 스크립트, 에셋 또는 예제만 불러오세요.

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

사용 방법

  • /fixing-motion-performance 이 대화에서 모든 UI 애니메이션 작업에 이러한 제약 조건을 적용합니다.

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

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

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

사용 시기

다음과 같은 경우 이 가이드라인을 참조하세요:

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

렌더링 단계 용어집

  • 합성(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 또는 position을 위해 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.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches 007: Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Agentfolio: Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Animejs Animation: Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astropy: Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astro: Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Emotional ARC Designer: One sentence - what this skill does and when to invoke it

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches I18n Localization: Internationalization and localization patterns.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Interactive Portfolio: Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches JQ: Expert jq usage for JSON querying, filtering, transformation, and pipeline integration.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Landing Page Generator: Generates high-converting Next.js/React landing pages with Tailwind CSS.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches LEX: Centralized ''Truth Engine'' for cross-jurisdictional legal context (US, EU, CA) and contract scaffolding.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Magic Animator: AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Makepad Animation: CRITICAL: Use for Makepad animation system.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs APP Router Patterns: Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

Anhvu1107/all-agent-skill

ALWAYS use this when the user mentions Nextjs Best Practices, asks to build, debug, review, document, automate, test, configure, migrate, or make decisions in this domain, or the task clearly depends on Nextjs Best Practices; scope: Next.js App Router principles. Apply the bundled workflow, references, scripts, Senior Master standard, and Codex strict review gate before final output.

Anhvu1107/all-agent-skill

description: ALWAYS use this when the work is specifically about modern Next.js or React architecture, data flow, rendering strategy, routing, or performance-sensitive frontend behavior.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs Supabase Auth: Expert integration of Supabase Auth with Next.js App Router

Anhvu1107/all-agent-skill

ALWAYS use this when the task involves reading, extracting, splitting, merging, rotating, creating, validating, OCR-ing, form-filling, or otherwise producing or modifying PDF files.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches React Nextjs Development: React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

Anhvu1107/all-agent-skill

ALWAYS use this when working with Remotion code, video compositions, rendering logic, timing, media assets, or React-based motion workflows.

관련 스킬