Communitygithub.com

kubai-holo-card

제품 내 신분증, 티켓, 배지, 개인 카드를 3D 경사와 지체 효과가 있는 홀로그램 카드로 변환합니다.

kubai-holo-card란 무엇인가요?

이 스킬은 사용자의 코어 제품 내에서 특정 카드 요소를 인터랙티브 홀로그램 카드로 변환하는 데 설계되었습니다. 주요 기능으로는 포인터를 향한 3D 기울기, 움직이는 빛에 따라 반짝이는 포일 및 글레어 효과, 내부 아트워크의 깊이 계층(시차 효과), 정지 상태의 흔들림, 클릭 시 뒷면 뒤집기 및 두께 표시가 포함됩니다. 사용자는 가이드 대화형 프롬프트를 통해 모든 매개변수를 커스터마이징할 수 있으며, 프리즘, 레인보우, 펄, 스파클, 크롬, 에칭 등 여섯 가지 마감재와 촉감, 두께 뒤집기, 깊이 계층에 대한 사전 설정을 제공합니다. 이 스킬은 기존 코드 및 디자인 시스템 내에서 원활하게 통합되도록 설계되어 있으며, 접근성(동작 감소)과 모바일 장치의 자이로스코프 지원을 고려합니다. 모든 값은 권장 사항이며 사용자가 최종 결정을 내립니다.

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

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

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

문서

기울어지고 뒤집히는 홀로그램 카드

《999개의 스킬: Vibe 제품의 완성도를 높이는 방법》 18화 · @kubai087

당신의 프로젝트에서 아래 요구사항대로 카드를 개조합니다. 요구사항은 당신의 관점에서 작성되었습니다: "I", "me", "my"는 당신을 의미합니다. "먼저 물어보라"는 곳에서 멈추고 당신의 선택을 기다린 후 진행합니다.

개조 요구사항

내 제품에서 카드를 홀로그램 카드로 변환: 포인터 방향으로 3D 기울임, 포일 마감과 글레어가 빛을 따라 움직임, 내부 아트웍은 깊이감을 가짐, 가만히 있을 때 살짝 흔들림, 원한다면 클릭 시 뒷면이 보이도록 뒤집히고 가장자리가 보임. 내 코드와 디자인 시스템 안에서 구축하되, 카드의 내용이나 기능은 변경하지 않음.

이 프롬프트의 모든 값은 권장 사항이며, 요구사항이 아닙니다. 섹션 1~7은 함께 작동하는 전체 세트("Standard" 값, 데모에서 테스트됨)를 제공하고, 섹션 9는 이를 기준으로 한 사전 설정을 제공합니다. 당신이 선택하고 내가 선택한 대로 구축합니다.

먼저 내 제품을 살펴봅니다(섹션 0). 그런 다음 다음 질문들을 하나씩 합니다. 각 질문에 대해 간단한 목록으로 옵션과 주요 값을 보여주고, 권장 옵션을 표시하며, 내 답변을 기다립니다. 옵션을 선택하거나, 개별 값을 변경하거나, 직접 값을 제시할 수 있습니다:

  1. 어떤 카드: 신분이나 소유권을 나타내는 하나의 요소 (멤버십/로열티 카드, 티켓/패스, 배지/업적, 프로필/수집 카드, 요금제 등). 홀로그램 효과는 모든 것이 빛나면 의미를 잃으므로, 한 화면에 하나의 카드만 적용합니다.

  2. 마감재: 섹션 3의 여섯 가지 중 하나(Prism 권장), 등급이나 희귀도에 따라 여러 개 선택, 또는 내 브랜드 색상(이 경우 base, foil, glare, rim, edge를 유도하여 보여줌).

  3. 촉감: Quiet, Standard(권장), Lively (섹션 9), 또는 직접 tilt angle, springs, sway 지정.

  4. 인터랙션: 포인터 방향 기울임(켜기), 유휴 흔들림(켜기), 클릭 시 뒤집기(뒷면 필요: QR코드, 약관 등 내용 지정), 모바일에서 기기 기울임 추적(끄기; iOS의 경우 권한 필요).

  5. 뒤집기 선택 시: 두께(Thin, Standard 권장, Thick)와 뒤집기 스프링(섹션 9).

  6. 깊이: 아트웍의 각 부분이 자체 레이어를 가질 깊이(None, Subtle, Standard 권장; 섹션 9).

  7. 배경: 카드 뒤편 페이지를 그대로 둠(대부분의 제품에 권장), 또는 느린 유체를 배경에 추가(섹션 7). 그런 다음 선택 사항을 표로 요약하고, 플랫폼(섹션 8 참고)에 구축할 방법, 비용 및 폴백을 제안한 후 진행 승인을 기다립니다.

  8. 기존 상태 파악

  • 카드 찾기: 컴포넌트, 크기, 코너 반경, 아트웍 및 내용, 위치, 주변 요소를 확인합니다. 이미 뒷면이 있는지 확인합니다(약관, 코드, 상세 정보 등).
  • 화면 그리기 방식(DOM, 네이티브 뷰 트리, GPU 렌더러), 플랫폼 버전 범위, 다크 모드 존재 여부, 포인터/터치 입력이 카드에 도달하는 방식을 확인합니다.
  • 질문 전에 몇 줄로 발견한 내용을 알려줍니다.
  1. 기울임과 빛 (Standard)
  • 포인터가 (fx, fy)에 있고 0..1 범위일 때, nx = fx * 2 - 1, ny = fy * 2 - 1, 목표값은 rotateY = nx * 12deg, rotateX = -ny * 12deg입니다. 카드 부모의 perspective는 1600px입니다.
  • 기울임은 스프링을 따라 목표값을 추적하여 포인터가 떠날 때 약간 오버슈트합니다: 가속도 = 140 * (target - angle) - 15 * velocity (초당).
  • 빛은 포인터가 있는 곳(lx = fx * 100%, ly = fy * 100%)에 위치하며 오버슈트 없는 스프링(stiffness 160, damping 2 * sqrt(160) ≈ 25.3)으로 따라갑니다. 포인터가 카드 위에 없으면, 방 안의 램프처럼 왼쪽 위(34%, 22%)에 고정됩니다.
  • Hover 강도 on은 포인터가 카드 위에 있는 동안 0에서 1로 증가하며, 프레임당 1 - exp(-7 * dt)로 부드럽게 전환됩니다. 이는 포일과 글레어를 밝게 합니다.
  • 가만히 있을 때, 카드는 손에 들린 듯 흔들립니다: rotateX = 2.2deg * sin(0.9t + 0.6) + 0.8deg * sin(2.3t), rotateY = 3.2deg * sin(0.7t) + 0.9deg * sin(1.9t + 1.2) (t는 초), 빛도 함께 움직입니다(lx = 34% + rotateY * 3, ly = 22% - rotateX * 3).
  • 터치: 카드를 드래그하면 같은 방식으로 기울입니다(카드에만 touch-action: none). 모바일 기기 기울임이 선택된 경우, 기기의 기울기를 동일한 목표 각도로 매핑합니다(클램프 적용).
  • 카드 아래 그림자: 흐린 타원(검은색 60%, blur 24px, 카드 너비의 84%, 높이 70px, 아래 30px)으로, 들어 올려진 쪽에서 멀어집니다: x = -rotateY * 1.8px, y = rotateX * 1.2px.
  1. 앞면의 레이어 (뒤에서 앞으로)
  • 아트: 카드 자체의 기본 색상 또는 그림.
  • Foil: 마감재(섹션 3), 아트 위에 블렌딩되며 빛 근처에서 가장 밝음.
  • Print: 카드에 인쇄된 모든 것(텍스트, 로고, 아트워크 윈도우), 가독성을 위해 포일 위에 위치.
  • Glare: 빛을 중심으로 한 방사형 그라데이션, 중앙은 흰색 60%, 28% 지점에서 14%, 95% 지점(가장 먼 모서리)에서 검은색 30%이며 overlay 모드로 블렌딩, 불투명도 0.35 + on * 0.65.
  • Rim: 가장자리를 따라 1.5px 링(mask with content-box exclude): 전체적으로 희미한 기본 색상, 그리고 빛 위치에 방사형 그라데이션(rim의 밝은 색상)이 적용되어 42% 지점에서 사라짐. 불투명도 0.6 + on * 0.4. 카드가 움직이며 나타났다 사라져야 하며, 고정된 외곽선으로 읽히지 않아야 함.
  • 홀로그램 씰: 카드에 자리가 있으면: 44px 디스크, conic-gradient(from , rgb(255 154 200), rgb(255 224 138), rgb(164 255 207), rgb(143 220 255), rgb(183 155 255), twice 반복), 위에 가는 링(흰색 35%, 3.5px마다 1px)과 60% 지점의 1px 흰색 테두리. 각도 = atan2(ly - 50%, lx - 50%) * 1.5 + rotateY * 6.
  • 모서리: 440 x 616 카드 기준 32px (카드 크기에 따라 스케일), 플랫폼이 지원하는 연속 곡선 사용.
  1. 마감재 (권장 값; 선택, 혼합 또는 브랜드 색상에서 유도) 각 항목: base, foil, glare, rim(섹션 2와 다를 경우), ink, edge color(두께용), 카드 뒤 빛(섹션 7).
  • Prism (권장): 내부에서 빛나는 진한 파란 유리.
    • Base: radial-gradient(60% 40% at 50% 0%, rgb(90 150 255 / 0.55), transparent), linear-gradient(170deg, rgb(13 35 168), rgb(8 18 102) 55%, rgb(22 15 92)). Ink rgb(244 244 246).
    • 아트워크 윈도우는 빛을 머금음: radial-gradient(46% 50% at the light, rgb(255 175 235) at 0.55, 0.4 at 18%, 0.22 at 38%, 0.09 at 60%, 0.02 at 82%, transparent), radial-gradient(54% 56% at (100% - lx, 74%), rgb(125 225 255) at 0.45, 0.32 at 18%, 0.17 at 38%, 0.07 at 60%, 0.015 at 82%, transparent), radial-gradient(70% 55% at 30% 100%, rgb(150 255 210 / 0.3), transparent 75%), 위에 linear-gradient(170deg, rgb(59 98 230), rgb(42 63 191) 55%, rgb(58 47 168)). 스탑이 많아 빛이 점으로 보이지 않고 광채로 읽힘. 프레임: rgb(140 170 255 / 0.1)에 1px 라인 rgb(170 200 255 / 0.28).
    • Foil: 2px 불빛 테두리, radial-gradient(at the light, rgb(170 220 255 / 0.9), transparent 60%), 링으로 마스킹됨. 불투명도 0.15 + on * 0.45. Glare 불투명도 0.25 + on * 0.45.
    • Edge rgb(26 42 138). Glow hue 228.
  • Rainbow: 기울임에 따라 움직이는 색상 띠.
    • Base: radial-gradient(130% 80% at 25% 0%, rgb(59 62 76), rgb(27 28 35) 62%). Ink rgb(245 245 247).
    • Foil: repeating-linear-gradient(115deg, rgb(255 95 126) 0%, rgb(255 184 107) 2.6%, rgb(244 255 107) 5.2%, rgb(107 255 181) 7.8%, rgb(95 210 255) 10.4%, rgb(139 123 255) 13%, rgb(255 107 214) 15.6%, rgb(255 95 126) 18%), background-size 200%, 배경 위치는 빛, 아래에 그레이팅 repeating-linear-gradient(125deg, transparent 0 2px, rgb(0 0 0 / 0.3) 2px 3px); mix-blend-mode color-dodge, filter brightness(0.72) saturate(1.25), 불투명도 0.3 + on * 0.6, radial-gradient(farthest-corner at the light, rgb(0 0 0) 5%, rgb(0 0 0 / 0.16) 72%)로 마스킹.
    • Edge rgb(42 44 53). Glow hue 285.
  • Pearl: 파스텔 광택이 있는 흰색 카드, 가장자리에서 가장 강하게 나타남.
    • Base: linear-gradient(160deg, rgb(253 252 255), rgb(241 238 248)). Ink rgb(23 21 46).
    • Foil: linear-gradient(115deg, rgb(255 196 225) 0%, rgb(201 184 255) 12%, rgb(180 233 255) 24%, rgb(194 255 216) 36%, rgb(255 243 184) 48%, then the same again), background-size 260%, 빛 위치, multiply, 불투명도 0.7 + on * 0.3, radial-gradient(70% 60% at 50% 45%, rgb(0 0 0 / 0.35) 30%, rgb(0 0 0) 100%)로 마스킹.
    • Glare: soft-light, 흰색 90%에서 55%까지 사라짐, 불투명도 0.5 + on * 0.5. Rim: 기본 rgb(60 50 120 / 0.06), 빛 부분 흰색 95%.
    • Edge rgb(230 226 242). Glow hue 300.
  • Sparkle: 미세한 반짝임.
    • Base: radial-gradient(120% 80% at 75% 5%, rgb(40 51 106), rgb(16 20 43) 65%). Ink rgb(238 240 255).
    • Glitter: 약 950개의 점으로 이루어진 240px 타일, 반지름 0.451.85px(대부분 작음), 알파 0.351, 알파 마스크로 사용.
    • Foil: screen 모드로 블렌딩, 두 레이어, 각각 글리터로 마스킹됨(두 번째는 117px, 71px 오프셋) 및 radial-gradient(at the light, rgb(0 0 0), rgb(0 0 0 / 0.3) 45%, rgb(0 0 0 / 0.12))로 마스킹: 첫 번째: repeating-linear-gradient(60deg, rgb(255 139 210) 0 3%, transparent 5% 8%, rgb(139 243 255) 10% 13%, transparent 15% 18%, rgb(255 243 139) 20% 23%, transparent 25% 28%), size 260%, position (lx * 1.6, ly); 두 번째: repeating-linear-gradient(-35deg, rgb(169 139 255) 0 3%, transparent 5% 9%, rgb(139 255 196) 11% 14%, transparent 16% 20%, rgb(255 255 255) 22% 24%, transparent 26% 30%), size 260%, position (100% - lx, ly * 1.4). 어두운 간격 덕분에 각 반짝임이 고유한 각도에서 빛났다가 사라짐.
    • Edge rgb(26 32 72). Glow hue 235.
  • Chrome: 하이라이트가 기울임과 반대로 움직이는 은색 거울.
    • Base: linear-gradient(125deg, rgb(228 230 234) 0%, rgb(141 147 158) 16%, rgb(246 247 249) 30%, rgb(124 130 141) 46%, rgb(217 220 225) 60%, rgb(148 154 165) 76%, rgb(241 242 244) 100%), background-size 220%, background-position (100% - lx, 100% - ly). Ink rgb(27 29 36).
    • Foil: linear-gradient(115deg, rgb(255 143 199), rgb(255 226 143) 14%, rgb(149 255 208) 28%, rgb(143 214 255) 42%, rgb(192 155 255) 56%, then again), size 240%, 빛 위치, overlay, 불투명도 0.3 + on * 0.35.
    • Glare: soft-light, 흰색 85%, 30%에서 10%, 95%에서 검은색 18%. Rim: 기본 흰색 18%, 빛 부분 흰색 95%. 인쇄된 선을 위한 조각된 듯한 느낌: text-shadow 0 -1px 0 rgb(60 64 76 / 0.55), 0 1px 0 rgb(255 255 255 / 0.95).
    • Edge rgb(180 184 194). Glow hue 200.
  • Etched: 빛 아래에서만 보이는 패턴.
    • Base: 무광 rgb(18 18 20)에 미세한 동심원 패턴, repeating-radial-gradient(circle at the artwork's center, rgb(255 255 255 / 0.05) 0 1.2px, transparent 1.6px 7px). Ink rgb(237 237 238).
    • Foil: linear-gradient(115deg, rgb(255 95 126), rgb(255 184 107) 10%, rgb(244 255 107) 20%, rgb(107 255 181) 30%, rgb(95 210 255) 40%, rgb(139 123 255) 50%, then again), size 300%, 빛 위치, 동일한 동심원 패턴과 radial-gradient(at the light, rgb(0 0 0), rgb(0 0 0 / 0.5) 18%, transparent 42%)로 마스킹됨; 불투명도 0.25 + on * 0.75. Glare 불투명도 0.2 + on * 0.4.
    • 아트워크 윈도우는 일반 무광 패널(radial-gradient(70% 60% at 50% 35%, rgb(29 29 33), rgb(15 15 17)))로 유지하여 원 패턴이 멈춤.
    • Edge rgb(27 27 30). Glow hue 190.
  • 모든 마감재에서 rim의 기본 색상은 별도 명시가 없으면 흰색 5%, 빛 색상은 흰색 50%입니다. 텍스트는 모든 각도에서 읽을 수 있어야 함: 그 아래 포일의 가장 밝은 순간과 가장 어두운 순간을 확인.
  1. 뒤집기 (선택된 경우에만; Standard 값)
  • 클릭(또는 탭, 포커스 상태에서 Enter/Space) 시 카드가 수직축을 중심으로 스프링(stiffness 70, damping 11)으로 180deg 회전하여 약 0.8초 후 작은 오버슈트로 안정화; 같은 동작으로 다시 뒤집힘.
  • 뒤집히는 동안 뷰어 쪽으로 들어 올려짐: translateZ(|sin(angle)| * 40px); 그림자는 최대 45% 좁아지고 가장자리에서 14px 아래로 내려감.
  • 두께 10px: 앞면은 카드 중간에서 5px 앞, 뒷면은 5px 뒤(180deg 회전), 둘 다 backface-visibility hidden; 그 사이에 마감재의 edge 색상으로 카드 윤곽선 10개가 균일한 간격으로 배치. 가장자리는 뒤집는 동안만 그림.
  • 뒷면은 동일한 마감재, 글레어, 림을 가지며 빛은 반사됨(lx가 100% - lx가 됨). 앞면과 동일한 여백으로 배치.
  • 앞면을 변경하는 모든 것(다른 마감재, 새 내용)은 카드가 가장자리일 때 변경되어 전환이 보이지 않도록 함.
  1. 아트워크 내부 깊이 (Standard 값)
  • 아트워크의 각 부분은 카드 앞면 뒤(음수: 앞면보다 앞)의 자체 깊이 d를 가지며, d * sin(angle)만큼 이동: x = -d * sin(rotateY + turn), y = d * sin(rotateX). 이것이 실제 3D가 하는 방식입니다.
  • 데모에서: 뒤에 있는 그림 90px, 나침반 다이얼 50px, 중간 링 34px, 점선 링 20px, 바늘은 앞으로 12px(-12); 모서리의 인쇄물은 표면에 고정되어 움직이지 않음. 가장 깊은 레이어는 윈도우보다 크게 그림(각 변에 100px씩)하여 가장자리가 보이지 않도록 함.
  • 아트워크가 반응할 수 있다면: 나침반 바늘이 포인터 방향으로 스프링으로 움직임(acceleration = 60 * angle difference - 5.5 * velocity, 짧은 경로), 가만히 있을 때 12deg * sin(0.77t) + 6deg * sin(2.16t)로 표류; 다이얼은 초당 9deg 회전, 점선 링은 반대 방향으로 초당 18deg 회전. 작고 느리며 하나의 움직이는 아이디어.
  1. 리듬과 접근성
  • 호버 인/아웃, 기울임, 빛은 연속적이며 뒤집기는 약 0.8초 후 안정화.
  • 마감재 전환: 앞면을 420ms에 걸쳐 교차 페이드 또는 뒤집기 중 가장자리에서 교체.
  • 동작 감소: 기울임, 흔들림, 뒤집기 애니메이션 없음(뒤집기는 즉시 교체 또는 200ms 교차 페이드가 됨); 빛은 여전히 포인터를 따라갈 수 있음; 배경은 정지.
  • 카드는 역할을 유지: 링크나 버튼은 그대로 유지, 뒷면은 키보드로 접근 가능하고 음성 안내됨, 중요한 정보가 특정 각도에서만 보이지 않도록 함.
  1. 배경 (선택된 경우에만)
  • 카드 뒤 빛: radial-gradient(closest-side, hsl(<finish's hue> 85% 64% / 0.3), transparent), 860px 너비, 불투명도 (0.04 + 0.12 * on) / 0.3.
  • 느린 유체 배경: value noise in fBm (4 옥타브, 각각 행렬 (1.6, 1.2; -1.2, 1.6)로 회전, 진폭 반감), 두 번 왜곡: p = position / height * 1.25 + flow; q = (fbm(p), fbm(p + (5.2, 1.3) - flow.yx)); r = (fbm(p + 3.5q + (1.7, 9.2) + 1.3 * flow), fbm(p + 3.5q + (8.3, 2.8) - flow)); f = fbm(p + 3r). Color = mix(a, b, clamp(2.4f²)), 그런 다음 clamp(0.95 * |q| - 0.35)로 c 쪽으로 혼합, 0.5 + 1.1f²를 곱함. 페이지 색상으로 페이드 아웃: smoo

…

[이하 내용 생략]

Individual skills in this repo

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

kubai-book-cards

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

kubai-easing-curves

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

kubai-liquid-glass

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

kubai-scroll-cards

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

관련 스킬