Communitygithub.com

kubai-easing-curves

프로젝트의 애니메이션에 사용 시나리오별로 완화 곡선과 지속 시간을 설정합니다: 등장은 ease-out, 퇴장은 ease-in, 위치 변화는 ease-in-out, 작은 확인 피드백은 overshoot, 드래그 후 놓을 때는 spring을 적용하고, 통합 동작 토큰(easing, motion curves)으로 관리합니다.

kubai-easing-curves란 무엇인가요?

이 스킬은 사용자의 기존 코드와 디자인 시스템 내에서 모든 트랜지션과 애니메이션을 찾아내고, 각각의 역할(등장, 퇴장, 이동, 제스처 등)에 맞는 올바른 완화 곡선과 지속 시간을 적용합니다. CSS, Framer Motion, GSAP, Web Animations API, requestAnimationFrame 루프 등 다양한 애니메이션 구현 방식을 지원하며, `--ease-out`, `--ease-in`, `--ease-in-out`, `--ease-overshoot`, `--ease-spring`, `linear`의 여섯 가지 토큰을 정의하여 일관성을 유지합니다. 또한 prefers-reduced-motion을 존중하고, 애니메이션이 사용자 입력을 차단하지 않도록 합니다. 각 단계별로 발견된 애니메이션 목록과 변경 사항을 사용자에게 보고하며, 명확한 역할이 없는 애니메이션은 사용자에게 먼저 질문합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-easing-curves

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

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

문서

시나리오별 완화 곡선 선택

《999가지 작은 팁, Vibe 제품의 품질을 높이는 방법》 011회 · @kubai087

사용자 프로젝트에서 아래 요구 사항에 따라 개선합니다. 요구 사항은 사용자의 어조로 작성합니다. 본문의 I, me, my는 사용자를 의미합니다. 먼저 질문해야 하는 부분은 사용자에게 멈추고 질문한 후 계속 진행하세요.

개선 요구 사항

내 제품의 모션에 올바른 완화 곡선을 적용하여, 요소들이 도착하고, 떠나고, 움직이는 방식을 자연스럽게 만듭니다. 내 기존 코드와 디자인 시스템 내에서 작업하세요. 각 애니메이션이 무엇을 하는지, 얼마나 멀리 움직이는지, 무엇이 트리거인지는 유지합니다. 시간에 따른 움직임 방식과 지속 시간을 변경합니다.

  1. 기존 상태에서 시작
  • 모든 트랜지션과 애니메이션을 찾습니다: CSS 트랜지션과 키프레임, 애니메이션 라이브러리(Framer Motion, GSAP, Web Animations API) 및 직접 작성한 requestAnimationFrame 루프. 각각을 컴포넌트, 트리거, 지속 시간, 곡선과 함께 목록으로 작성합니다.
  • CSS 기본값 ease, 움직이는 요소에 사용된 linear, 등장하는 요소에 사용된 ease-in을 표시합니다.
  1. 곡선을 토큰으로 정의 다른 모션 토큰 옆에 한 번 정의하고, 다음만 사용합니다:
  • --ease-out: cubic-bezier(0, 0, .58, 1). 등장하는 모든 것: 토스트, 메뉴, 팝오버, 다이얼로그, 드로어.
  • --ease-out-strong: cubic-bezier(.22, 1, .36, 1). 클릭 직후 작은 요소들이 자리 잡을 때: 아이콘, 레이블, 선택된 필. 가장 반응성이 느껴집니다.
  • --ease-in: cubic-bezier(.42, 0, 1, 1). 떠나는 모든 것, 그리고 그것만: 토스트가 사라질 때, 다이얼로그나 드로어가 닫힐 때, 메뉴가 접힐 때, 목록 항목이 스와이프되어 사라질 때. 느리게 시작하여 최고 속도로 떠나므로, 등장에 사용하면 느리게 느껴지다가 갑자기 멈춥니다.
  • --ease-in-out: cubic-bezier(.42, 0, .58, 1). 화면에 그대로 있으면서 위치나 크기만 변경되는 것: 탭이나 세그먼트 컨트롤 아래의 표시기, 캐러셀 페이지 넘김, 재정렬 중 항목들이 공간을 만들 때, 사이드바 크기 조정, 앵커로 부드러운 스크롤. 등장에 사용하지 마세요. 느린 시작이 지연으로 보입니다.
  • --ease-overshoot: cubic-bezier(.34, 1.56, .64, 1). 목표 위치보다 약 10% 더 갔다가 돌아옵니다. 작고 재미있는 확인 동작: 체크박스 체크, 좋아요, 배지 카운트 팝인, 스위치 노브가 자리 잡을 때. 다이얼로그, 드로어 또는 약 64px보다 큰 요소에는 절대 사용하지 마세요. 그리고 사용자가 하루 종일 반복하는 동작에도 사용하지 마세요.
  • --ease-spring: linear(0, .32, .78, 1.04, 1.09, 1.06, 1.02, 1, .99, .99, 1). 드래그나 스와이프 후 놓은 요소가 물체처럼 안착되도록 합니다: 바텀 시트가 열리거나 닫힐 때, 반 스와이프 후 카드가 돌아올 때, 당겨서 새로고침이 튕겨 돌아올 때, 재정렬된 항목이 제자리에 떨어질 때. 애니메이션 라이브러리 자체의 스프링을 놓는 속도와 함께 사용하는 것을 선호합니다. 이 토큰은 라이브러리가 없는 경우에만 사용하고, linear()가 지원되지 않는 경우 --ease-out-strong으로 대체합니다.
  • linear: 움직이는 것이 아니라 회전하거나 진행되는 것에만 사용: 스피너, 진행률 표시줄, 마키.
  • CSS 기본값 ease는 선택 사항이 아닙니다. 곡선이 설정되지 않은 모든 곳을 대체하세요.
  1. 지속 시간
  • 작은 UI (토스트, 툴팁, 메뉴, 체크): 등장 150-250ms, 퇴장 120-200ms. 퇴장이 등장보다 짧습니다.
  • 중간 (다이얼로그, 콘텐츠 포함 팝오버, 드로어): 250-350ms.
  • 크거나 전체 화면 (시트, 페이지 전환): 350-500ms. 더 길면 느리게 느껴집니다.
  • 스프링과 오버슈트: 일반 지속 시간의 약 1.5배. 안착하는 데 시간이 걸리기 때문입니다.
  • 지속 시간을 곡선 옆에 토큰으로 유지합니다 (--duration-sm, -md, -lg).
  1. 역할별 적용
  • 등장: ease-out, 요소가 속한 위치에서 (토스트는 위쪽 가장자리에서, 메뉴는 트리거에서) 짧은 거리(8-24px)로, 96%에서 시작하여 약간 일찍 페이드 인하며 움직입니다. 토스트에는 가벼운 블러(약 8px)가 사라지면서 깔끔해지는 효과를 주면 좋습니다.
  • 퇴장: ease-in, 같은 경로를 반대로, 더 짧게.
  • 화면 이동: ease-in-out.
  • 방금 등장한 요소 내부의 부품(아이콘, 텍스트, 카운트)은 100-200ms 후에 강한 ease-out으로 이어질 수 있으므로 한 번에 모두가 아니라 단계별로 안착됩니다.
  • 제스처: 포인터나 손가락이 움직이는 동안은 완화 없이 1:1로 따라갑니다. 놓으면 스프링으로 마무리하며, 라이브러리가 허용하면 놓는 속도를 사용합니다.
  • 호버 및 누름: 100-150ms ease-out. 호버 시 레이아웃을 애니메이션하지 마세요.
  • transform과 opacity를 애니메이션하고 (filter는 필요한 경우만) top, left, width, height는 사용하지 마세요. 이들은 모든 프레임에서 레이아웃과 리페인트를 발생시킵니다.
  1. 일관성 유지 및 접근성
  • 제품 전체에서 역할당 하나의 곡선. 각 컴포넌트를 수동으로 조정하지 마세요.
  • prefers-reduced-motion 존중: 투명도 변경은 유지하고, 움직임과 크기 변경은 제거하며, 스프링과 오버슈트는 일반 150ms 페이드로 변경합니다.
  • 사용자가 애니메이션을 기다리게 하지 마세요. 입력을 차단하지 않으며, 새 동작이 진행 중인 애니메이션을 현재 상태에서 중단시킵니다.
  1. 결과물 제출
  • 먼저 발견한 모든 애니메이션, 현재 곡선과 지속 시간, 그리고 적용할 역할과 곡선을 목록으로 작성합니다.
  • 그런 다음 토큰을 추가하고, 각 애니메이션을 전환하며, 수정한 모든 파일을 목록으로 작성합니다.
  • 무엇이 애니메이션되는지, 얼마나 멀리 움직이는지, 무엇이 트리거인지는 변경하지 마세요. 애니메이션에 명확한 역할이 없으면 먼저 나에게 물어보세요.

Individual skills in this repo

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

kubai-book-cards

卡片在悬停或聚焦时像书一样翻开一定角度,显示里面的内页,静止时外观保持不变。提供普通卡片、拟物精装书和极简文档三种风格。适用于文档、知识库、作品集和模板市场(book hover cards)。

kubai-holo-card

把产品里代表身份或收藏的卡片(会员卡、门票、徽章、个人卡片)改成镭射卡片:卡片朝指针方向 3D 倾斜,镭射与高光随光线移动,内部图案按深度产生视差,静止时轻微晃动,点击可翻到背面并显示厚度。附 Prism、Rainbow、Pearl、Sparkle、Chrome、Etched 六种材质的推荐参数,以及手感、厚度、翻转和层次的几档预设。开始前逐项询问,每项给出推荐值,由你选择或调整,确认后再按现有技术栈改造(holographic card, foil, 3D tilt, parallax)。

kubai-liquid-glass

为图片、壁纸或视频上方的卡片和面板添加液态玻璃材质:背景模糊与提亮、边缘折射与色散、根据背景自动调整的着色和文字颜色,深色和浅色模式下文字都清晰可读,布局保持不变(liquid glass, glassmorphism)。

kubai-scroll-cards

改造现有长页面:选出值得讲的段落,用五种由滚动驱动的卡片交互呈现——层叠卡片(新卡片逐张盖住旧卡片,旧卡片缩小、变暗)、卡组飞出(顶部卡片向一侧甩出,下一张顶上来)、横向展廊(页面固定,纵向滚动推动横向作品集)、封面轮播(中间一张最大,两侧缩小、转开、变暗)、图片展开(小图铺满屏幕,标题从景物后升起形成景深)。效果全部由滚动位置驱动,读者控制节奏,回滚即倒放,不劫持滚动;尺寸按不同屏幕和视窗高度计算,手机工具栏不会挡住内容,矮屏自动退回普通段落。附多档预设,开始前逐项询问,由你选择或调整,确认后按现有技术栈实现(scroll-driven animation, sticky, cover flow, svh)。

관련 스킬