Communitygithub.com

kubai-book-cards

카드가 호버 또는 포커스 시 책처럼 일정 각도로 펼쳐지며, 정지 상태에서는 원래 모습을 유지합니다. 일반 카드, 아날로그 양장본, 미니멀 문서 세 가지 스타일을 제공합니다. 문서, 지식 베이스, 포트폴리오, 템플릿 마켓에 적합합니다.

kubai-book-cards란 무엇인가요?

이 스킬은 사용자의 프로젝트에 '책처럼 펼쳐지는 카드(Book Hover Cards)' 효과를 적용하는 방법을 상세히 안내합니다. 호버나 포커스 시 카드가 책 표지처럼 살짝 열리며 내부 페이지를 드러내고, 정지 상태에서는 원래의 디자인을 그대로 유지하여 사용자에게 신선한 인터랙션 경험을 제공합니다. 세 가지 스타일(기본 제품 카드, 아날로그 양장본, 미니멀 문서)을 지원하며, 각 스타일마다 표면 질감, 그림자, 타이포그래피, 배경 등 세부 요소를 조정할 수 있습니다. 또한 강도, 페이지 수, 힌지 방향, 트리거 방식, 페이지 내용 등 다양한 옵션을 제공하여 프로젝트의 분위기와 요구사항에 맞게 커스터마이징할 수 있습니다. CSS 변환과 그라데이션, 블러 처리를 활용한 3D 레이어 스택 방식으로 구현되며, 접근성과 성능까지 고려한 실용적인 솔루션입니다.

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

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

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

문서

호버 시 책처럼 펼쳐지는 카드

《999가지 작은 팁, 당신의 Vibe 제품에 품격을 더하는 방법》 제006호 · @kubai087

사용자의 프로젝트에서 아래 요구사항에 따라 수정합니다. 요구사항은 사용자의 관점으로 작성되었습니다: 문장 속 I, me, my는 사용자를 가리킵니다; "먼저 질문하라"고 적힌 부분은 잠시 멈추고 사용자에게 질문한 후 계속 진행하세요.

수정 요구사항

내 제품의 카드가 호버될 때 책처럼 살짝 펼쳐지도록 만듭니다. 정지 상태에서 카드는 오늘날의 모습과 정확히 동일해야 합니다. 오직 호버 또는 포커스만이 그 안에 페이지가 있는 작은 책임을 드러냅니다.

0. 기존 상태에서 시작하기

  • 내가 이름을 지정한 카드 컴포넌트(또는 내가 가리킨 그리드나 리스트에서 사용된 카드)를 찾아 그 자리에서 리트로핏합니다. 해당 카드의 마크업, 디자인 토큰, 반경, 그림자, 모션/스프링 유틸리티를 재사용합니다.
  • 카드의 점유 공간, 패딩, 콘텐츠, 레이아웃을 변경하지 않습니다. 카드 주변의 어떤 것도 움직이면 안 됩니다.
  • 대신 새 카드를 요청하면, 아래에서 선택한 스타일로 새로운 정사각형 카드(약 280 x 280)를 만듭니다.
  • 내가 설정하지 않은 모든 옵션은 기본값(*)을 사용합니다.

1. 스타일 선택하기

기본값*: 일반 제품 카드, 호버되기 전까지는 일반 카드와 동일합니다.

  • 표면: 순수 흰색(또는 내 카드 표면 토큰), 질감 없음.
  • 테두리: 내 테두리 색상의 1px 가는 선.
  • 그림자: 밝고 중성적인 차가운 회색, 절반 강도.
  • 서체: 제품 산세리프. 제목 24/600, 설명 15(흐릿하게), 메타 14(흐릿하게).
  • 표지: 기존 카드 UI: 48px 아이콘 타일, 오른쪽 상단 ↗ 화살표, 제목, 설명, 가는 선 아래 메타 푸터.
  • 배경: 나의 일반 페이지 배경.
  • 페이지: 흰색, 등쪽으로 희미한 음영, 작은 제목과 4-6줄의 회색 텍스트.

아날로그 양장본(Skeuomorphic): 갤러리 벽에 걸린 하드커버 책.

  • 표면: 진한 표지 색상 위의 정교한 책 천 질감.
  • 테두리: 빛이 비치는 베벨: 밝은 상단 테두리, 어두운 하단.
  • 그림자: 따뜻하고 중성에 가까운 회색(주황색 아님), 최대 강도.
  • 서체: 왼쪽 하단에 하나의 세리프 제목. 표지에는 이것만 있음.
  • 표지: 전체 채우기 이미지 또는 애니메이션 ASCII 씬, 상단에 부드러운 광택, 하단에 음영.
  • 배경: 미세한 질감의 따뜻한 플라스터, 각 책 위에 스포트라이트.
  • 페이지: 질감이 있는 크림색 종이, 기울임꼴 챕터 제목, 양쪽 정렬된 줄, 앞쪽 가장자리를 따라 얇은 페이지 가장자리.

미니멀 문서(Minimal): 문서 볼륨.

  • 표면: 평평한 오프 화이트, 밝은 회색 또는 흑연, 카드당 하나의 톤.
  • 테두리: 희미한 베벨 또는 가는 선.
  • 그림자: 차가운 중성 회색.
  • 서체: 가는 선 위에 단색 섹션 번호와 버전; 두 줄 산세리프 제목과 하단의 작은 회색 레이블.
  • 표지: 잉크 색상의 단일 요소가 있는 하나의 작은 회색 선 다이어그램.
  • 배경: 희미한 24px 도트 그리드와 위에서 내리비치는 부드러운 빛이 있는 차가운 회색.
  • 페이지: 차가운 흰색, 산세리프 제목과 회색 줄.

내 제품에 맞추기(Match my product): 내 토큰에서 표면, 테두리, 그림자, 서체, 배경을 가져오고, 표지는 오늘날의 카드 모양 그대로 유지합니다.

2. 옵션 (기본값은 *로 표시)

  • 강도(Intensity): 미세(24도) | 책*(42도) | 극적(60도).
  • 페이지 수(Pages): 2 | 3 | 4* | 6.
  • 힌지 방향(Hinge): 왼쪽* | 오른쪽 | 위쪽.
  • 트리거(Trigger): 호버* | 누름(누르는 동안 열림) | 스크롤 시 표시(60% 보일 때 한 번 열리고 약 1.2초 후 닫힘). 키보드 포커스도 항상 엽니다.
  • 페이지 표시(Pages show): 빈 종이 | 텍스트 줄* | 카드의 실제 미리보기 콘텐츠(다음 필드, 짧은 목록, 차트 썸네일).
  • 표지(Cover): 기존 카드 UI* | 이미지 | 애니메이션 ASCII 씬 | 단색.
  • 그림자 방향(Shadow direction): 위에서* | 왼쪽 위에서.
  • 그림자 강도(Shadow strength): 없음 | 약함 | 보통* | 강함.
  • 모서리(Corners): 내 토큰에 맞춤* | 연속형(초타원형).
  • 모션 감각(Motion feel): 재빠름(k 320, 댐핑 0.9) | 기본*(k 240, 댐핑 0.86) | 부드러움(k 160, 댐핑 0.8). 모두 거의 오버슛하지 않음.
  • 모션 감소(Reduced motion): 약간 들어올림* | 아무것도 하지 않음.
  • 터치(Touch): 누름* | 스크롤 시 표시 | 끄기.

3. 레이어 스택

  • 카드의 링크 안에서, transform-style: preserve-3d가 적용된 body 요소 위에 표지를 배치합니다. 뒤쪽에 N개의 페이지와 뒷판을 쌓습니다. 모두 같은 정사각형 위에 절대 위치(absolutely positioned)로 배치합니다.
  • 순서(앞에서 뒤로): 표지(n=0), 페이지(n=1..N), 뒷판(n=N+1, 절대 움직이지 않음).
  • 표지는 카드의 모든 기존 콘텐츠를 유지합니다. 페이지와 뒷판은 장식용입니다: aria-hidden, 링크 없음, 탭 정지점 없음.
  • 정적 외부 요소의 원근법(Perspective): 약 1100px, 원점은 힌지 쪽으로(왼쪽 힌지의 경우 30% 50%, 오른쪽의 경우 70% 50%, 위쪽의 경우 50% 30%).
  • 모든 레이어의 힌지 가장자리에 transform-origin: 왼쪽 0 50%, 오른쪽 100% 50%, 위쪽 50% 0. backface-visibility: hidden.
  • 레이어 n을 translateZ((N + 1 - n) x 0.6px)만큼 들어올려 레이어가 깊이에서 충돌하지 않도록 합니다.
  • 페이지는 표지 안쪽 8px(등쪽 4px)에 위치하며, 반경 = 표지 반경 - 8.
  • 뒷판: 평면 카드(기본, 미니멀)에서는 표지에서 약 6px 안쪽으로 설정하고 반경 = 표지 반경 - 6으로 하여 표지의 단축된 모서리 밖으로 삐져나오지 않도록 합니다. 아날로그 양장본에서는 표면과 동일하게 하고 표지 색상을 약 28% 어둡게 합니다.

4. 모션

  • 레이어 n은 시청자 쪽으로 angle(n) = A x 0.7^n만큼 회전하며 delay(n) = 28ms x n 후에 시작됩니다. 표지가 앞서고 페이지가 그 뒤를 따라 펼쳐집니다.
  • 방향: 왼쪽 힌지는 rotateY(-angle), 오른쪽 힌지는 rotateY(+angle), 위쪽 힌지는 rotateX(+angle).
  • 각 레이어는 자체 스프링(모션 감각 참조)으로 작동하며 약 0.3초 안에 안정됩니다.
  • 닫힘은 역순으로: 가장 안쪽 페이지가 먼저, delay = 28ms x (N - n) 후에 0도로 돌아갑니다.
  • 포인터가 중간에 떠나면 현재 각도와 속도에서 대상을 다시 설정합니다. 절대 점프하지 않습니다.
  • 프로젝트에 스프링 헬퍼가 없나요? CSS 전환도 괜찮습니다: 약 420ms 동안 변환 전환, 약간의 오버슈트(예: cubic-bezier(0.3, 1.2, 0.5, 1)), 열린 상태에서는 transition-delay를 28ms x n으로, 정지 상태(대상 상태의 딜레이가 적용되므로 닫힘은 역순으로 실행됨)에서는 28ms x (N - n)으로 설정합니다.

5. 빛과 음영

  • 빛은 위에서 오므로 그림자는 벽 아래로 떨어집니다.
  • 그림자는 카드 뒤에 있는 두 개의 단색 모양으로, 각각 한 번씩 블러 처리됩니다. 정지 상태에서는 일반 평면 카드의 그림자처럼 카드에 밀착됩니다:
    • 접촉 그림자(contact): 작고 더 어두우며, 카드 하단에 위치. 카드의 아래쪽 절반, 각 측면에서 약 4px 안쪽, 블러 약 4px, 약 2px 아래, 약 22% 불투명도.
    • 주변 그림자(ambient): 희미함. 블러 약 14px, 약 6px 아래, 약 12% 불투명도.
  • 절대 box-shadow를 사용하지 마십시오: 속이 빈 링이며 표지가 벗겨지면 외곽선으로 보입니다.
  • 색조: 벽 쪽으로 기울어진 중성 회색(따뜻한 벽에는 따뜻한 회색, 차가운 벽에는 차가운 회색). 절대 순수한 검정색이나 채도 높은 색은 사용하지 않습니다.
  • 강도는 두 불투명도를 스케일링합니다: 밝음 0.5(기본 스타일), 보통 1, 깊음 1.4.
  • 열림: 더 길고 부드러운 두 번째 사전 블러 쌍(접촉 블러 약 12px, 12px 아래; 주변 블러 약 38px, 26px 아래)으로 크로스페이드하고, transform을 사용하여 약 14px 더 아래로, 약 4% 더 넓게 이동시킵니다. 자체 스프링(k 200, 댐핑 0.9)으로 하나의 진행 값 o(0..1)를 구동합니다: 정지 쌍 불투명도 1 - o, 열린 쌍 불투명도 o.
  • 잎 음영(Leaf shading): 모든 페이지에는 등쪽(32% 어두움 -> 55%에서 8% -> 85%에서 0)의 오버레이 그라데이션이 있습니다. 불투명도는 clamp(gap / 6, 0, 1) x max(0, 1 - gap / 30)이며, 여기서 gap = 앞쪽 잎의 각도에서 이 잎의 각도를 뺀 값입니다. 페이지는 앞쪽 잎이 막 떠오를 때 음영 처리되고, 떨어진 후에는 밝아집니다.
  • 표지(아날로그 양장본, 미니멀): 상단 가장자리에 부드러운 광택, 하단에 약간의 음영.

6. 모서리와 가장자리

  • 모든 레이어(표지, 페이지, 뒷판)를 하나의 모양 경로로 클리핑하고, 해당 경로를 따라 가장자리(가는 선 또는 베벨)를 그립니다(예: 레이어 위에 선으로 그려진 SVG 경로). CSS border나 inset box-shadow를 클립과 혼합하지 마십시오: 모서리에서 일치하지 않으며 레이어가 분리될 때 두 번째 테두리가 나타납니다.
  • 내 토큰에 맞춤: 토큰 반경 사용; 중첩 반경 = 외부 반경 - 여백.
  • 연속형: 초타원형 모서리 |x|^n + |y|^n = 1, n = 2^1.25 (CSS corner-shape: superellipse(1.25)와 동일한 곡선). 레이어 크기당 clip-path: path(...)를 생성하고 가장자리에 재사용하며 크기 조정 시 다시 생성합니다.

7. 상호작용 및 접근성

  • 정지 상태의 점유 공간에서 히트 테스트: 정적 외부 요소에서 호버를 수신하고 모든 움직이는 레이어에 pointer-events: none을 지정하여 흔들리는 표지가 대상을 이동시키지 않고 카드 가장자리에서 열리고 닫히는 깜박임이 없도록 합니다.
  • 커서: 카드 전체에 손가락 모양 커서.
  • 전체 카드는 하나의 또는 으로 유지되며 현재 접근 가능한 이름을 가집니다. 페이지는 접근성 트리에 아무것도 추가하지 않습니다.
  • :focus-visible은 호버와 정확히 동일하게 엽니다. 외부 요소에 포커스 링을 정지 상태 모양을 따라 유지합니다.
  • 모션 감소: 펼쳐짐이나 회전이 없습니다. 표지가 약 2px 들어올려지고 그림자가 열린 쌍으로 크로스페이드됩니다.
  • 터치: 호버 없음. 터치 옵션 사용; 탭은 첫 번째 시도에서 카드를 활성화해야 합니다.

8. 성능

  • transform과 opacity만 애니메이션합니다. 절대 blur, box-shadow, clip-path, width, height, top/left를 애니메이션하지 마십시오.
  • 절대 블러 반경을 애니메이션하지 마십시오: 각 그림자를 한 번 블러 처리하고 두 개의 사전 블러 처리된 버전을 크로스페이드합니다.
  • 모든 카드에 대해 하나의 requestAnimationFrame 루프. 스프링이 정지된 카드는 건너뛰고 아무것도 움직이지 않으면 루프를 중지합니다.
  • 값이 변경될 때만 스타일을 작성합니다(요소당 마지막 문자열을 캐시).
  • 프레임당 레이아웃 읽기 없음: 한 번 측정하고 크기 조정 시(ResizeObserver) 다시 측정합니다.
  • 애니메이션 캔버스 표지: 최대 약 30fps로 그리고 화면 밖(IntersectionObserver) 또는 탭이 숨겨졌을 때 일시 중지합니다.

9. 애니메이션 ASCII 표지 (선택된 경우에만)

  • 문자 셀(약 6 x 9px)당 하나의 색상으로 작은 장면을 그립니다.
  • 밝기로 " .:-=+*#%@"에서 각 문자를 선택합니다.
  • 아래에 색상의 흐릿한 복사본(약 40%)을 그리고 그 위에 색상이 있는 문자를 그려서 간격이 하프톤처럼 보이도록 합니다.
  • 매 프레임 텍스트를 배치하는 대신 사전 렌더링된 글리프 아틀라스에서 문자를 스탬프합니다. 움직임을 느리고 매끄럽게 반복되도록 유지합니다.

10. 완료 시

  • 변경하거나 추가한 모든 파일을 나열합니다.
  • 사용한 스타일과 모든 옵션을 나열하고 기본값을 표시합니다.
  • 정지 상태에서 더 이상 동일하게 보이지 않는 항목이 있으면 기록합니다.

Individual skills in this repo

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

kubai-easing-curves

按使用场景为项目中的动画设置缓动曲线和时长:入场用 ease-out,离场用 ease-in,位置变化用 ease-in-out,小的确认反馈用 overshoot,拖动松手后用 spring,并统一为动效 token(easing, motion curves)。

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)。

관련 스킬