Communitygithub.com

Andersonlimahw/lemon-ai-hub

모션 토큰, 스프링 프리셋, React/Next.js(motion/react) 상호작용 패턴으로, 영상 속 제품 UI를 충실히 재현하고 탐색 가능한 장면으로 애니메이션 처리하며, 실제 제품 모션을 영상과 일관성 있게 유지합니다.

lemon-ai-hub란 무엇인가요?

이 스킬은 제품 UI의 모션을 정의하고 구현하기 위한 포괄적인 패턴과 토큰 시스템을 제공합니다. 'Andersonlimahw/lemon-ai-hub'는 두 가지 주요 작업을 수행합니다. 하나는 실제 웹 제품 UI에 애니메이션을 적용하는 것이고, 다른 하나는 영상 속 제품 UI를 재설계 없이 충실히 재구축하는 것입니다. 두 작업 모두 동일한 모션 토큰(duration, easing, distance, stagger)과 스프링 프리셋(press, snappy, gentle, layout, camera)을 사용하여 일관성을 보장합니다. React/Next.js 환경에서 `motion/react` 라이브러리를 기반으로 하며, 접근성(useReducedMotion), SSR 호환성, 그리고 12가지 구체적인 인터랙션 패턴(버튼 프레스, 조건부 렌더링, 페이지 전환, 리스트 스태거, 모달/시트, 토스트, 숫자 변경 등)을 규칙과 함께 제공합니다. 영상 작업을 위해서는 측정 기반 접근, 하이브리드 렌더링, 재설계 금지, 클린 캡처, 그리고 탐색 가능한(seekable) 애니메이션을 위한 시간 기반 값 사용을 강조합니다. 웹 전용 작업 시에는 `design-expert` 검증 게이트를 통과해야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Andersonlimahw/lemon-ai-hub/tree/HEAD/plugins/motion-movie-expert/skills/ui-motion-patterns

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

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

문서

UI 모션 패턴

두 가지 작업: 실제 제품 UI를 웹에서 애니메이션 처리하고, 재설계 없이 영상용 제품 UI를 재구축합니다. 두 작업 모두 동일한 토큰을 사용합니다.

1. 토큰 우선

모션을 한 번 정의하고 모든 곳에서 가져옵니다. 컴포넌트에 인라인 숫자를 사용하지 마세요.

// lib/motion-tokens.ts
export const motionTokens = {
  duration: { instant: 0.1, fast: 0.18, normal: 0.3, slow: 0.5, scene: 0.7 },
  easing: {
    standard: [0.2, 0, 0, 1],   // enter + move
    exit: [0.4, 0, 1, 1],       // leave
    emphasized: [0.3, 0, 0, 1],
  },
  distance: { nudge: 4, small: 8, medium: 16, large: 32 },
  stagger: 0.06,                // 0.05에서 0.10 사이 유지
} as const;

export const springs = {
  press:   { type: "spring", stiffness: 600, damping: 38 },  // 버튼, 토글
  snappy:  { type: "spring", stiffness: 420, damping: 34 },  // 칩, 메뉴
  gentle:  { type: "spring", stiffness: 260, damping: 27 },  // 카드, 패널
  layout:  { type: "spring", stiffness: 320, damping: 30 },  // 재정렬, 크기 조정
  camera:  { type: "spring", stiffness: 140, damping: 20 },  // 큰 이동, 영상 전용
} as const;

질량 1 기준, 감쇠비 ζ = damping / (2·√stiffness): press 0.78, snappy 0.83, gentle 0.84, layout 0.84, camera 0.85 — 모두 0.75–0.90 대역 내에 있으며 (오버슛 ≤ ~6 %). 이 공식을 사용하여 브랜드에 맞게 조정하고, 이 테이블을 단일 정보 출처로 유지하세요.

2. 접근성 및 SSR

"use client";
import { useReducedMotion } from "motion/react";

export function useSafeMotion() {
  const reduce = useReducedMotion();
  return {
    reduce,
    // reduced motion: 변환 제거, 짧은 불투명도 변경(≤0.2초) 유지
    enter: reduce ? { opacity: 1 } : { opacity: 1, y: 0 },
    initial: reduce ? { opacity: 0 } : { opacity: 0, y: 8 },
    transition: reduce ? { duration: 0.2 } : undefined,
  };
}
  • 첫 페인트에서 이미 보이는 요소에는 initial={false}를 사용하여 하이드레이션 플래시를 방지하세요.
  • transform과 opacity만 애니메이션 처리하세요. 루프에서 width, height, top, left 또는 box-shadow를 절대 애니메이션 처리하지 말고, layout이나 scale을 대신 사용하세요.
  • 저사양 기기: 지속 시간을 단축하고 장식용 모션은 건너뛰세요.

3. 패턴 및 규칙

패턴규칙
버튼 프레스whileTap={{ scale: 0.96 }}와 springs.press 사용; 100ms 이내 피드백
조건부 렌더링안정적인 key와 함께 AnimatePresence로 감싸기; 모든 initial + animate는 exit를 가져야 함
페이지 / 라우트 전환AnimatePresence mode="wait": exit가 완료된 후 enter 시작
리스트 스태거staggerChildren 0.05–0.10초; 스태거 아이템은 ~8개로 제한, 나머지는 함께 나타남
재정렬 / 크기 조정작은 서브트리(≲5 자식)에서만 layout 사용; 그 외에는 명시적 x/y 사용
모달 / 시트포커스 트랩, Escape 닫힘, 스크롤 잠금, role="dialog", aria-modal="true", 포커스 반환
토스트위치한 가장자리에서 진입; 호버/포커스 시 자동 닫힘 일시 중지
숫자 변경수직 롤: 이전 값이 위로 흐려지며 나가고, 새 값이 아래에서 들어옴; font-variant-numeric: tabular-nums 사용
스크롤 시 나타남whileInView와 viewport={{ once: true }} 사용; 스크롤 아웃 시 절대 다시 애니메이션 처리하지 않음
로딩 → 성공버튼이 압축 → 스피너 → 체크; 버튼 너비는 안정적으로 유지

4. 영상용 제품 UI 재구축

  • 측정하고 추측하지 마세요. 제품 소스나 계산된 스타일에서 토큰을 가져오세요: 색상, 반경, 글꼴 패밀리/두께/자간, 간격, 아이콘 세트 및 선 두께. 실제 스크린샷에서 색상을 샘플링하여 비교하세요.
  • 하이브리드 기본값. 실제 스크린샷을 컨텍스트로 사용; 애니메이션 처리할 요소만 픽셀 정렬로 재구축하여 그 위에 배치하세요.
  • 명시적 승인 없이 재설계하지 마세요. 새로운 색상, 글꼴, 아이콘 또는 카피는 안 됩니다.
  • 깨끗하게 캡처하세요. 로그아웃 상태 또는 데모 계정, 가상 데이터, 개인식별정보(PII) 없음, 사용자가 소유하지 않은 제3자 브랜드 없음.
  • 탐색 가능하게. 영상에서는 모든 애니메이션 값을 절대 시간으로 구동하세요(value = f(t)), motion/react 런타임 상태가 아닙니다. 라이브 웹에는 motion/react를, 렌더링된 영상에는 폐쇄형 스프링 또는 GSAP 타임라인을 사용하세요.

이 패턴을 영상 대신 웹사이트에서 사용할 때는 배송 전에 design-expert 검증 게이트(키보드, 포커스, reduced motion, 성능)를 실행하세요.

Individual skills in this repo

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

Andersonlimahw/lemon-ai-hub

When the user wants to plan a product launch, feature announcement, or release strategy. Also use when the user mentions 'launch,' 'Product Hunt,' 'feature release,' 'announcement,' 'go-to-market,' 'beta launch,' 'early access,' 'waitlist,' 'product update,' 'how do I launch this,' 'launch checklist,' 'GTM plan,' or 'we're about to ship.' Use this whenever someone is preparing to release something publicly. For ongoing marketing after launch, see marketing-ideas. For the offer being launched (bonuses, guarantees, scarcity, naming), see offers.

Andersonlimahw/lemon-ai-hub

Create and edit motion videos end to end — product motion films, motion graphics, narrated explainers, captioned clips, UI animation recreations, and recuts. Orchestrates brief, storyboard, choreography, build (HyperFrames or any deterministic renderer), voice/caption sync, and render QC. Use when the user asks to make, animate, storyboard, narrate, caption, edit, or render a video or motion piece; skip for static images and web UI work with no video deliverable.

Andersonlimahw/lemon-ai-hub

Build and render a deterministic video composition — HyperFrames (HTML + GSAP) by default, or a custom seek(t) + Playwright + FFmpeg pipeline. Covers project setup, composition contract, timeline rules, creative direction for frames, lint/check/snapshot, preview, and local render. Use when implementing an approved storyboard as code.

Andersonlimahw/lemon-ai-hub

Motion law for multi-scene videos — seam continuity (axis, direction, speed, phase), carriers, causal motion, springs and timing, camera, transitions, stillness, and loop design. Use when planning or fixing how scenes connect and move, before and during any animation build.

Andersonlimahw/lemon-ai-hub

Short design-led motion graphics where motion is the message — kinetic typography, stat count-up, chart/data-viz reveal, logo sting, lower third or callout, animated map, tweet/news/headline card, webpage or UI walkthrough, and image-plus-data fusion. Usually under 10 s, up to about 30 s, no narration; renders to MP4 or a transparent overlay. Use when the user wants a short motion graphic, animated stat/chart/logo/map/card, or overlay; when the upstream HyperFrames `motion-graphics` skill is installed, use it for exact CLI flags and registry blocks.

Andersonlimahw/lemon-ai-hub

Turn a video idea, product, or script into an approved master prompt and pre-implementation storyboard — intake, concept, 8–12 state sequence, beat grid, transition map, camera plan, audio cue plan, and render architecture. Use before building any new video, or when a video brief is vague.

Andersonlimahw/lemon-ai-hub

Edit existing video and verify any render before delivery — recut, trim, reframe to other aspect ratios, burn in or attach captions, swap or remix audio, loop, and export; plus the QC gates (probe, contact sheet, stills per beat, loudness, loop seam, legibility, facts, PII). Use for editing footage or for the final check of any motion video.

Andersonlimahw/lemon-ai-hub

Synchronize narration, captions, music, and SFX with picture — narration writing, script lock, TTS or recorded voiceover, word-level timestamps, caption blocks, shot windows derived from the voice track, dwell budgets, ducking, and loudness targets. Use for narrated explainers, voiceover changes, subtitles, or any video where timing must follow audio.

Andersonlimahw/lemon-ai-hub

Agent skill at plugins/video/SKILL.md

관련 스킬