사용 가이드로 건너뛰기
fixing-motion-performance작성자 Julien Thibeaut

Fixing Motion Performance 스킬.

모션 및 비디오를 위한 Claude Code 및 Codex 스킬: 버벅거리는 CSS/JS 애니메이션과 스크롤 연동 모션을 찾아 수정합니다.

  • Motion & Video
  • 리뷰 리포트
ibelick/ui-skills · skills/fixing-motion-performance/SKILL.mdSKILL.md
--- name: fixing-motion-performance description: Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance. --- ## how to use ## when to apply ## rendering steps glossary ## rule categories by priority ## common fixes ## review guidance
상위 파일에서 읽은 머리말 및 섹션 제목 2026-09-14 · 전체 5,561자

01 기능

Claude Code와 Codex에서 fixing-motion-performance 스킬이 수행하는 작업

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

CSS 및 JS 애니메이션 성능에 대한 감사 및 수정 플레이북으로, 부자연스러운 전환, 스크롤 연동 모션, 블러 효과를 검토하거나 리팩터링하는 디자이너와 개발자를 대상으로 합니다. 슬래시 명령으로 제공되며, 단독으로 실행하면 대화 중인 애니메이션 작업 전반에 가이드라인을 적용하고, 파일을 지정하면 정확한 줄을 인용하여 위반 사항, 이유, 코드 수준의 수정안을 보고합니다.

규칙은 우선순위에 따라 정렬되며, 절대 금지 패턴과 메커니즘·도구 경계를 최우선으로 다룬 뒤 측정, 스크롤, 페인트, 레이어, 블러를 거쳐 뷰 전환까지 이어집니다. 요청이 없는 한 애니메이션 라이브러리를 마이그레이션하지 않으며, 기존 스택 내에서 규칙을 적용합니다.

산출물

  • 위반 사항마다 왜 중요한지를 설명하는 짧은 문장 한 줄.
  • 각 위반 사항에 대한 구체적인 코드 수준의 수정안.
  • 기본값이 아닌 렌더링 작업 선택에 대한 명시적인 근거.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    슬래시 명령으로 실행하기

    /fixing-motion-performance를 실행하여 세션에서 이미 논의 중인 애니메이션 작업에 제약을 적용합니다.

  2. 02
    또는 파일을 지정하기

    경로를 전달하면 실시간 작업을 제약하는 대신 해당 파일을 모든 규칙에 대해 검토하는 리뷰 모드로 전환됩니다.

  3. 03
    세 부분으로 보고하십시오

    각 발견 사항은 문제가 되는 줄을 인용하고, 왜 중요한지를 짧은 문장으로 설명하며, 코드 수준의 수정안을 제안합니다.

  4. 04
    렌더링 단계별로 속성 정렬하기

    용어집은 작업을 합성, 페인트, 레이아웃으로 구분하여 리뷰어가 어떤 애니메이션이 저렴하고 어떤 애니메이션이 비용이 큰지 파악할 수 있게 합니다.

  5. 05
    우선순위에 따라 적용하기

    영향이 큰 카테고리를 낮은 영향의 카테고리보다 먼저 검토하므로, 절대 금지 패턴과 도구 경계가 가장 먼저 정리됩니다.

  6. 06
    현재 스택 안에서 유지하기

    라이브러리 마이그레이션은 작업 범위에 포함되지 않으며, 규칙은 코드베이스가 이미 사용 중인 애니메이션 시스템에 그대로 적용됩니다.

02 적합성 확인

fixing-motion-performance Skill을 사용하는 경우

Claude Code 또는 Codex에서 이러한 종류의 모션 및 비디오 작업일 때 fixing-motion-performance 스킬을 사용합니다. 아래 적합성 및 제한 사항은 스킬 자체 파일에서 가져왔습니다.

적합한 경우

  • CSS, WAAPI, Motion, rAF 또는 GSAP로 작성된 UI 애니메이션을 추가하거나 변경하는 경우.
  • 이미 부자연스럽게 느껴지는 인터랙션이나 전환을 리팩터링하는 경우.
  • 현재 scroll 이벤트로 동작하는 스크롤 연동 모션이나 스크롤 시 등장 효과를 구현하는 경우.
  • 레이아웃, 필터, 마스크, 그레이디언트 또는 CSS 변수를 애니메이션화하는 경우로, 비용 프로파일 자체가 핵심 문제인 상황.
  • will-change, transform 또는 측정에 의존하는 컴포넌트를 리뷰하는 경우.

한계 인지하기

  • 네비게이션 수준 변경을 넘어서는 뷰 전환, 예를 들어 인터랙션이 많은 UI나 중단 가능해야 하는 플로우.
  • 지속적이거나 넓은 영역에 적용되는 블러 효과는 최적화 대상이 아니라 배제 대상입니다.

제공할 사항

  • 슬래시 명령어 단독 사용실시간 작업의 경우 명령어를 그대로 호출하는 것만으로 충분하며, 이후 대화에서 이루어지는 애니메이션 변경 작업의 방향을 정합니다.
  • 리뷰 모드용 파일 경로파일 하나를 전달하면 스킬이 해당 파일을 모든 규칙에 대해 검토하고 위반 사항 보고서를 생성합니다.
  • 기존 애니메이션 시스템대상 라이브러리를 별도로 지정하지 않으며, 현재 상태의 코드가 기준이 되어 그 안에서 규칙이 적용됩니다.

03 스킬 내부

fixing-motion-performance 스킬이 Claude Code와 Codex에 제공하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. 읽기와 쓰기를 절대 교차시키지 않음

    레이아웃 읽기와 쓰기는 같은 프레임 내에서 섞이면 안 되며, 레이아웃을 측정하거나 변경하는 여러 애니메이션 시스템을 동시에 실행해서도 안 됩니다.

  2. 스크롤 위치로부터 애니메이션을 절대 구동하지 않음

    scrollTop, scrollY 또는 scroll 이벤트로 애니메이션을 구동하는 것은 금지되며, 대신 Scroll 또는 View Timelines와 IntersectionObserver를 사용해야 합니다.

  3. 모든 rAF 루프에는 종료 조건이 필요함

    중단 조건이 없는 requestAnimationFrame 루프는 허용 가능한 트레이드오프가 아니라 절대 사용하지 말아야 할 패턴입니다.

  4. 기본값은 transform과 opacity

    이들은 컴포지터 속성이며 모션의 출발점이 되고, JS 기반 애니메이션은 이것이 반드시 필요한 인터랙션에만 사용됩니다.

  5. 블러는 8px로 제한

    블러 애니메이션은 8px 이하의 작은 값을 유지해야 하며 짧은 일회성 효과로 제한되고, 지속적인 블러와 넓은 영역에 대한 블러는 사용할 수 없습니다.

  6. will-change는 정밀하게 사용

    레이어 승격은 자동으로 이루어지지 않으므로, will-change는 다수 또는 넓은 승격 레이어에 계속 남겨두지 않고 일시적이고 좁은 범위로 적용됩니다.

  7. 모션을 위해 CSS 변수를 애니메이션화하지 마십시오

    transform, opacity 또는 position을 제어하는 커스텀 속성은 애니메이션화해서는 안 되며, 상속된 애니메이션 변수는 전면적으로 금지됩니다.

  8. 부분적인 마이그레이션 금지

    하나의 컴포넌트 내에서 API를 부분적으로만 마이그레이션해서는 안 되며, 애니메이션 스타일을 혼용해서는 안 됩니다.

04 활용하기

Claude Code 또는 Codex에 fixing-motion-performance 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 사용자의 Agent에 fixing-motion-performance 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/ibelick/ui-skills --skill fixing-motion-performance

skills/fixing-motion-performance/SKILL.md에 대한 일반적인 skills CLI 형식이며, 저장소는 자체 경로를 문서화할 수 있습니다.

스킬에 첫 번째 모션 및 비디오 작업 제공

스킬 자체의 용어로 작성되었습니다. 대괄호 부분은 각자의 자료로 교체합니다.

Starter prompt
Use /fixing-motion-performance on [path/to/Component.tsx]. The [side panel] transitions width on hover, the reveal-on-scroll is wired to a window scroll listener, and there is a blurred overlay on a full-width section. Report each violation with the exact line, why it matters, and a concrete fix, working within our existing [Motion] setup rather than migrating libraries.

출처: 스킬 자체의 용어로 SKILL.md에서 작성했습니다.

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • 제안된 수정이 의도된 효과에 부합하면서도 가장 비용이 적은 렌더링 작업을 수행하는지 확인합니다.
  • 화면 밖으로 이동한 요소가 실제로 일시 정지되거나 정지되었는지, 계속 실행 중인 채로 방치되지 않았는지 확인합니다.
  • 레이어 승격이 중요한 경우, 이를 가정하지 말고 도구로 검증합니다.

OpenDesign에서 fixing-motion-performance를 SKILL.md 링크에서 가져옵니다: Plugins → Add → Skill → Import from link, 그런 다음 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

Repository
github.com/ibelick/ui-skills 브랜치 main
스킬 파일
skills/fixing-motion-performance/SKILL.md 검증 시점에 콘텐츠 체크섬 기록됨; 커밋 79081ab
License
MIT LICENSE에서 확인
리포지토리 스타
8,402 GitHub 스냅샷은 2026-09-14에 ibelick/ui-skills 저장소 전체에 대해 촬영되었으며, 이 저장소는 카탈로그에 5개의 스킬을 포함합니다. fixing-motion-performance에 대한 평점이나 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 사용 방법단독 호출은 세션을 제한하고, 파일 인수를 전달하면 전체 위반 보고서가 생성됩니다.
  2. 적용 시점애니메이션 작업 중 이 가이드라인을 적용해야 하는 다섯 가지 상황을 나열합니다.
  3. 렌더링 단계 용어집합성, 페인트, 레이아웃을 정의하고 각 단계가 다루는 속성을 설명합니다.
  4. 우선순위별 규칙 분류영향 수준 라벨과 함께 순위가 매겨진 아홉 개 범주로, 심각(critical)에서 낮음(low)까지입니다.
  5. 빠른 참조절대 금지 패턴부터 도구 경계까지, 짧은 항목형 제약 조건으로 이루어진 아홉 개의 번호가 매겨진 범주입니다.
  6. 일반적인 수정 사항레이아웃 스래싱, 스크롤 연동 모션, FLIP 측정에 대한 CSS 및 JS 전/후 코드 조각입니다.
  7. 검토 지침검토 진행 방법: 심각한 문제 우선, 가장 저렴한 작업, 정당화된 비기본 선택, 실행 가능한 노트.
스킬 자체 설명
"레이아웃 스래싱, 컴포지터 속성, 스크롤 연동 모션, 블러 효과를 포함한 애니메이션 성능 문제를 감사하고 수정합니다. 애니메이션이 끊기거나 전환이 버벅거리거나 CSS/JS 애니메이션 성능을 검토할 때 사용합니다."

SKILL.md의 프론트 매터 설명입니다. 전체 파일은 약 5,561자입니다. GitHub에서 전체 파일 읽기.

06 설치하기 전에

fixing-motion-performance 스킬에 대한 질문

이 답변은 2026-09-14 기준으로 확인한 SKILL.md 내용을 근거로 하며, 실행 기록을 바탕으로 한 것이 아닙니다.

어떤 애니메이션 라이브러리를 다룹니까?

적용 범위로 CSS, WAAPI, Motion, rAF, GSAP를 명시하고 있어 특정 프레임워크에 종속되지 않고 광범위합니다. 기존 시스템 내에서 규칙을 적용하기 때문에, 사용 중인 것이 무엇이든 그에 맞게 조정됩니다.

Fixing Motion Performance

실제 모션 및 비디오 작업에 fixing-motion-performance를 실행합니다.

OpenDesign를 다운로드하고, SKILL.md 링크에서 fixing-motion-performance를 가져온 다음, 위 프롬프트를 붙여넣고 결과 전에 계획을 읽으십시오.

터미널
npx skills add https://github.com/ibelick/ui-skills --skill fixing-motion-performance

OpenDesign 데스크톱

하나의 디자인 시스템으로 모든 결과물에 브랜드 일관성을

완전한 Vibe Design Workspace에서 하나의 브랜드 규칙을 웹사이트, 슬라이드, 인터랙티브 프로토타입, 대시보드, 이미지, HTML 영상에 적용하세요. 로컬 Codex, Claude Code, Cursor 등을 연결해 무료로 제작할 수 있습니다.

  • 웹, 슬라이드, 프로토타입, 대시보드, 이미지, 영상
  • 140개+ 디자인 시스템과 전체 템플릿·스킬 라이브러리
  • 로컬 Codex 및 21개+ 코딩 에이전트 연결 · 무료
무료 다운로드

macOS, Windows 지원