Communitygithub.com

Desesbraker/agentes-vip

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

agentes-vip란 무엇인가요?

이 스킬은 웹 애니메이션 성능 문제를 진단하고 수정하는 전문 도구입니다. 레이아웃 스래싱(thrashing), 컴포지터(compositor) 속성, 스크롤 연동 모션, 블러 및 필터 효과 등 다양한 성능 저하 요인을 체계적으로 분석합니다. Claude Code, Cursor, Codex 등 주요 AI 에이전트 플랫폼에서 사용할 수 있으며, `/fixing-motion-performance` 명령어를 통해 대화 중인 UI 애니메이션 작업에 성능 제약 조건을 적용합니다. 특정 파일을 지정하면 코드 라인 단위로 위반 사항을 찾아내고, 그 중요성을 설명하며, 구체적인 수정 코드를 제안합니다. 우선순위가 매겨진 9가지 규칙 카테고리(절대 금지 패턴, 메커니즘 선택, 측정, 스크롤, 페인트, 레이어, 블러/필터, 뷰 전환, 도구 경계)를 기반으로 하여, 가장 비용이 적게 드는 렌더링 방식을 선택하도록 유도합니다. 애니메이션 라이브러리를 명시적 요청 없이 마이그레이션하지 않으며, 기존 스택 내에서 규칙을 적용하는 것이 핵심 원칙입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/plugins/antigravity-awesome-skills-claude/skills/fixing-motion-performance

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

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

문서

모션 성능 수정하기

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

사용 방법

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

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

    • 위반 사항 (정확한 라인 또는 코드 조각 인용)
    • 이유 (한 문장으로 간략히)
    • 구체적인 수정 방법 (코드 수준 제안)

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

사용 시기

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

  • 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를 사용하십시오
  • 스크롤 위치를 애니메이션을 위해 폴링(poll)하지 마십시오
  • 화면 밖에서는 애니메이션을 일시 중지하거나 중단하십시오
  • 스크롤 연동 모션은 큰 표면에서 지속적인 레이아웃이나 페인트를 유발해서는 안 됩니다

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

  • 페인트를 유발하는 애니메이션은 작고 분리된 요소에서만 허용됩니다
  • 큰 컨테이너에서 페인트 부하가 큰 속성을 애니메이션하지 마십시오
  • transform, opacity 또는 position에 대해 CSS 변수를 애니메이션하지 마십시오
  • 상속된 CSS 변수를 애니메이션하지 마십시오
  • 애니메이션되는 CSS 변수는 로컬 범위로 한정하고 상속을 피하십시오

6. 레이어 (중간)

  • 컴포지터 모션에는 레이어 승격이 필요하며, 절대 가정하지 마십시오
  • will-change는 임시로, 그리고 정확히 필요한 곳에만 사용하십시오
  • 많거나 큰 승격된 레이어를 피하십시오
  • 성능이 중요할 때 도구를 사용하여 레이어 동작을 검증하십시오

7. 블러 및 필터 (중간)

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

8. 뷰 전환 (낮음)

  • 뷰 전환은 탐색 수준 변경에만 사용하십시오
  • 인터랙션이 많은 UI에는 뷰 전환을 피하십시오
  • 중단이나 취소가 필요한 경우 뷰 전환을 피하십시오
  • 크기 변경은 잠재적으로 레이아웃을 유발할 수 있음에 유의하십시오

9. 도구 경계 (치명적)

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

일반적인 수정 방법

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

/* 스크롤 연동: JS 대신 scroll-timeline 사용 */
/* before */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* after */  .reveal { animation: fade-in linear; animation-timeline: view(); }
// 측정: 쓰기 전 읽기 일괄 처리 (FLIP)
// before — 레이아웃 스래싱
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// after — 한 번 측정 후 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 16 individual skills — each has its own dedicated page.

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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 悬停效果

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

Desesbraker/agentes-vip

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

Desesbraker/agentes-vip

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

Desesbraker/agentes-vip

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

Desesbraker/agentes-vip

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

관련 스킬