Communitygithub.com

ComeOnOliver/skillshub

기능을 분석하고 목적 있는 애니메이션과 마이크로 인터랙션을 추가하여 사용성을 개선하고 사용자에게 즐거움을 제공합니다.

skillshub란 무엇인가요?

이 스킬은 개발자가 기존 기능을 분석하고 전략적으로 애니메이션과 마이크로 인터랙션을 추가하여 사용자 경험을 향상시키도록 도와줍니다. 단순히 장식용 애니메이션을 추가하는 것이 아니라, 피드백 제공, 관계 표현, 전환 부드럽게 처리, 그리고 미묘한 즐거움을 통해 기능의 이해도를 높이고 사용성을 개선하는 데 초점을 맞춥니다. 이 스킬은 코드베이스 또는 컨텍스트에서 대상 사용자, 사용 사례, 브랜드 성격, 성능 제약을 먼저 파악하고, 추론이 불확실할 경우 질문을 통해 명확히 한 후에 애니메이션 계획을 수립합니다. 'frontend-design' 스킬을 함께 사용하여 디자인 원칙과 안티패턴을 확인하는 것을 필수로 요구하며, CSS 전환, JavaScript 애니메이션 라이브러리 등 다양한 기술을 제안하고, GPU 가속을 위한 `transform`과 `opacity` 사용, 성능 모니터링, 그리고 `prefers-reduced-motion` 미디어 쿼리를 통한 접근성 준수를 강조합니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/pbakaus/animate

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

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

문서

기능을 분석하고 전략적으로 애니메이션과 마이크로 인터랙션을 추가하여 이해도를 높이고, 피드백을 제공하며, 즐거움을 창출합니다.

필수 준비 사항

컨텍스트 수집 (먼저 수행)

훌륭한 작업을 수행하려면 대상 사용자(중요), 원하는 사용 사례(중요), 브랜드 성격/톤(장난기 vs 진지함, 활기참 vs 차분함), 성능 제약 조건과 같은 필요한 컨텍스트를 확보해야 합니다.

현재 스레드나 코드베이스에서 이러한 정보를 수집하세요.

  1. 정확한 정보를 찾을 수 없고 기존 디자인과 기능을 추론해야 하는 경우, 반드시 중단하고 {{ask_instruction}} 질문을 통해 올바르게 추론했는지 확인하세요.
  2. 그렇지 않으면, 완전히 추론할 수 없거나 확신 수준이 중간 이하인 경우, 먼저 {{ask_instruction}}로 명확한 질문을 하여 컨텍스트를 완성하세요.

답변을 얻을 때까지 진행하지 마세요. 추측은 부적절하거나 과도한 애니메이션으로 이어집니다.

frontend-design 스킬 사용

디자인 원칙과 안티패턴을 확인하려면 frontend-design 스킬을 사용하세요. 이 스킬이 실행되어 모든 Do's와 Don'ts를 알 때까지 진행하지 마세요.


애니메이션 기회 평가

모션이 경험을 개선할 수 있는 부분을 분석하세요:

  1. 정적 영역 식별:

    • 피드백 부족: 시각적 확인이 없는 동작 (버튼 클릭, 폼 제출 등)
    • 갑작스러운 전환: 순간적인 상태 변경이 어색하게 느껴지는 경우 (표시/숨김, 페이지 로드, 경로 변경)
    • 불명확한 관계: 공간적 또는 계층적 관계가 명확하지 않은 경우
    • 즐거움 부족: 기능적이지만 재미없는 인터랙션
    • 안내 부족: 주의를 환기하거나 동작을 설명할 기회를 놓친 경우
  2. 컨텍스트 이해:

    • 성격은 무엇인가요? (장난기 vs 진지함, 활기참 vs 차분함)
    • 성능 예산은 얼마인가요? (모바일 우선? 복잡한 페이지?)
    • 대상 사용자는 누구인가요? (모션에 민감한 사용자? 속도를 원하는 파워 유저?)
    • 가장 중요한 것은 무엇인가요? (하나의 히어로 애니메이션 vs 여러 마이크로 인터랙션)

이 중 코드베이스에서 명확하지 않은 것이 있으면 {{ask_instruction}}

중요: prefers-reduced-motion을 존중하세요. 필요한 사용자를 위해 항상 애니메이션이 없는 대안을 제공하세요.

애니메이션 전략 수립

목적 있는 애니메이션 계획을 만드세요:

  • 히어로 모먼트: 하나의 시그니처 애니메이션은 무엇인가요? (페이지 로드? 히어로 섹션? 핵심 인터랙션?)
  • 피드백 레이어: 어떤 인터랙션에 인정(acknowledgment)이 필요하나요?
  • 전환 레이어: 어떤 상태 변경을 부드럽게 처리해야 하나요?
  • 즐거움 레이어: 어디에서 놀라움과 즐거움을 줄 수 있나요?

중요: 잘 조율된 하나의 경험이 여기저기 흩어진 애니메이션보다 낫습니다. 영향력이 큰 순간에 집중하세요.

애니메이션 구현

다음 카테고리에 걸쳐 체계적으로 모션을 추가하세요:

진입 애니메이션

  • 페이지 로드 코레오그래피: 요소 표시 순차 지연 (100-150ms 지연), 페이드 + 슬라이드 조합
  • 히어로 섹션: 주요 콘텐츠에 대한 극적인 진입 (스케일, 패럴랙스 또는 창의적인 효과)
  • 콘텐츠 표시: 인터섹션 옵저버를 사용한 스크롤 트리거 애니메이션
  • 모달/드로어 진입: 부드러운 슬라이드 + 페이드, 배경 페이드, 포커스 관리

마이크로 인터랙션

  • 버튼 피드백:
    • 호버: 미묘한 스케일 (1.02-1.05), 색상 변화, 그림자 증가
    • 클릭: 빠른 축소 후 확대 (0.95 → 1), 리플 효과
    • 로딩: 스피너 또는 펄스 상태
  • 폼 인터랙션:
    • 입력 포커스: 테두리 색상 전환, 약간의 스케일 또는 글로우
    • 유효성 검사: 오류 시 흔들림, 성공 시 체크 표시, 부드러운 색상 전환
  • 토글 스위치: 부드러운 슬라이드 + 색상 전환 (200-300ms)
  • 체크박스/라디오: 체크 표시 애니메이션, 리플 효과
  • 좋아요/즐겨찾기: 스케일 + 회전, 파티클 효과, 색상 전환

상태 전환

  • 표시/숨김: 페이드 + 슬라이드 (즉시 아님), 적절한 타이밍 (200-300ms)
  • 확장/축소: 오버플로 처리가 포함된 높이 전환, 아이콘 회전
  • 로딩 상태: 스켈레톤 스크린 페이드, 스피너 애니메이션, 진행 표시줄
  • 성공/오류: 색상 전환, 아이콘 애니메이션, 부드러운 스케일 펄스
  • 활성화/비활성화: 불투명도 전환, 커서 변경

탐색 및 흐름

  • 페이지 전환: 경로 간 크로스페이드, 공유 요소 전환
  • 탭 전환: 슬라이드 인디케이터, 콘텐츠 페이드/슬라이드
  • 캐러셀/슬라이더: 부드러운 트랜스폼, 스냅 포인트, 관성
  • 스크롤 효과: 패럴랙스 레이어, 상태 변경이 있는 고정 헤더, 스크롤 진행 표시기

피드백 및 안내

  • 호버 힌트: 툴팁 페이드 인, 커서 변경, 요소 강조
  • 드래그 & 드롭: 들어올림 효과 (그림자 + 스케일), 드롭 존 강조, 부드러운 재배치
  • 복사/붙여넣기: 붙여넣기 시 짧은 강조 플래시, "복사됨" 확인
  • 포커스 흐름: 폼 또는 워크플로우를 통한 경로 강조

즐거움을 위한 순간

  • 빈 상태: 일러스트레이션의 미묘한 떠다니는 애니메이션
  • 완료된 작업: 컨페티, 체크 표시 장식, 성공 축하
  • 이스터 에그: 발견을 위한 숨겨진 인터랙션
  • 컨텍스트 애니메이션: 날씨 효과, 시간대 테마, 계절감

기술 구현

각 애니메이션에 적절한 기술을 사용하세요:

타이밍 및 이징

목적별 지속 시간:

  • 100-150ms: 즉각적인 피드백 (버튼 누름, 토글)
  • 200-300ms: 상태 변경 (호버, 메뉴 열림)
  • 300-500ms: 레이아웃 변경 (아코디언, 모달)
  • 500-800ms: 진입 애니메이션 (페이지 로드)

이징 곡선 (CSS 기본값 대신 이것들을 사용하세요):

/* 권장 - 자연스러운 감속 */
--ease-out-quart: cubic-bezier(0.25, 1, 0.5, 1);    /* 부드럽고 세련됨 */
--ease-out-quint: cubic-bezier(0.22, 1, 0.36, 1);   /* 약간 더 경쾌함 */
--ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);     /* 자신감 있고 단호함 */

/* 피해야 할 것 - 구식이고 저렴해 보임 */
/* bounce: cubic-bezier(0.34, 1.56, 0.64, 1); */
/* elastic: cubic-bezier(0.68, -0.6, 0.32, 1.6); */

종료 애니메이션은 진입보다 빠릅니다. 진입 지속 시간의 약 75%를 사용하세요.

CSS 애니메이션

/* 간단하고 선언적인 애니메이션에 선호 */
- 상태 변경에는 transitions
- 복잡한 시퀀스에는 @keyframes
- transform + opacity만 사용 (GPU 가속)

JavaScript 애니메이션

/* 복잡한 대화형 애니메이션에 사용 */
- 프로그래밍 제어를 위한 Web Animations API
- React용 Framer Motion
- 복잡한 시퀀스용 GSAP

성능

  • GPU 가속: transform과 opacity를 사용하고 레이아웃 속성은 피하세요
  • will-change: 알려진 비용이 많이 드는 애니메이션에만 제한적으로 추가하세요
  • 페인트 줄이기: 리페인트를 최소화하고 적절한 곳에 contain을 사용하세요
  • FPS 모니터링: 대상 기기에서 60fps를 보장하세요

접근성

@media (prefers-reduced-motion: reduce) {
  * {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

절대 금지:

  • 바운스 또는 탄성 이징 곡선 사용 - 구식으로 보이고 애니메이션 자체에 주의를 끕니다
  • 레이아웃 속성 (width, height, top, left) 애니메이션 - 대신 transform을 사용하세요
  • 피드백에 500ms 이상의 지속 시간 사용 - 지연처럼 느껴집니다
  • 목적 없이 애니메이션 사용 - 모든 애니메이션에는 이유가 필요합니다
  • prefers-reduced-motion 무시 - 이는 접근성 위반입니다
  • 모든 것에 애니메이션 적용 - 애니메이션 피로는 인터페이스를 피로하게 만듭니다
  • 의도적이지 않은 한 애니메이션 중 상호 작용 차단

품질 확인

애니메이션을 철저히 테스트하세요:

  • 60fps로 부드럽게: 대상 기기에서 끊김 없음
  • 자연스러움: 이징 곡선이 유기적으로 느껴지고 로봇 같지 않음
  • 적절한 타이밍: 너무 빠르지도 (어색함) 너무 느리지도 (지연) 않음
  • 모션 감소 작동: 애니메이션이 비활성화되거나 적절히 단순화됨
  • 차단하지 않음: 사용자가 애니메이션 중/후에 상호 작용할 수 있음
  • 가치를 더함: 인터페이스를 더 명확하게 하거나 즐겁게 만듦

기억하세요: 모션은 이해를 돕고 피드백을 제공해야 하며, 단순한 장식이 되어서는 안 됩니다. 목적을 가지고 애니메이션을 적용하고, 성능 제약을 존중하며, 항상 접근성을 고려하세요. 훌륭한 애니메이션은 보이지 않습니다. 그저 모든 것이 제대로 느껴지게 만들 뿐입니다.

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

관련 스킬