Communitygithub.com

kubai-liquid-glass

이미지, 배경화면 또는 비디오 위의 카드와 패널에 액체 유리 재질을 추가합니다: 배경 흐림 및 밝기, 가장자리 굴절 및 색 분산, 배경에 따라 자동 조정되는 색조와 텍스트 색상, 어두운 모드와 밝은 모드에서도 텍스트가 선명하게 읽히며 레이아웃은 그대로 유지됩니다.

kubai-liquid-glass란 무엇인가요?

이 스킬은 제품의 카드, 플레이어, 검색 바, 툴바, 메뉴, 팝오버 등 다양한 표면 위에 현실감 있는 '액체 유리' 재질을 구현합니다. CSS 변수와 backdrop-filter, box-shadow, SVG 필터를 활용하여 배경에서 색을 흡수하고 가장자리에서 굴절 및 색 분산을 만들어내는 두껍고 투명한 유리판 같은 효과를 줍니다. 이 재질은 밝은 모드와 어두운 모드 모두에서 자동으로 텍스트 가독성을 유지하며, 기존 디자인 시스템의 레이아웃, 간격, 글꼴을 변경하지 않고 표면만 교체합니다. 주로 Chromium 기반 브라우저(Chrome, Edge)에서 완전히 동작하며, Firefox 등에서는 CSS 전용 유리 효과로 우아하게 폴백합니다. 스킬은 사용자가 변경할 표면 목록을 먼저 확인한 후 진행하며, 각 표면의 배경을 실시간으로 샘플링하여 색조와 텍스트 색상을 동적으로 조정합니다.

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

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

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

문서

액체 유리 재질

《999가지 작은 팁, 당신의 Vibe 제품의 품질을 높이는 방법》 제010호 · @kubai087

사용자의 프로젝트를 아래 요구사항에 따라 개조하세요. 요구사항은 사용자의 어조로 작성되었습니다. 본문의 I, me, my는 사용자를 가리킵니다. 먼저 물어봐야 하는 부분이 있으면, 멈추고 사용자에게 질문한 후 계속 진행하세요.

개조 요구사항

제품의 카드와 패널에 액체 유리 재질을 적용하세요: 뒤에 있는 장면에서 색을 가져오는 투명한 유리, 가장자리에서 두꺼운 판처럼 보이며, 뒤에 있는 것에 적응하고, 밝은 모드와 어두운 모드에서도 텍스트를 읽기 쉽게 유지합니다. 기존 디자인 시스템 내에서 작업하세요. 이는 표면의 변경이지 레이아웃의 변경이 아닙니다: 마크업, 간격, 모서리 반경, 글꼴, 아이콘 및 텍스트는 그대로 유지하세요.

  1. 현재 상태에서 시작
  • 이미지, 배경화면, 비디오 또는 복잡한 배경 위에 있는 모든 표면을 찾으세요: 카드, 플레이어, 검색 바, 툴바, 메뉴, 팝오버, 토스트. 해당 구성 요소와 위치를 목록으로 작성하세요.
  • 제품이 밝은 모드와 어두운 모드 사이를 전환하는 방법과 색상 토큰이 어디에 있는지 확인하세요. 유리는 각 구성 요소가 아닌 토큰에 적용됩니다.
  • 단색 배경 위의 표면은 그대로 두세요. 단색 위의 유리는 회색으로만 보입니다.
  1. 재질을 토큰으로 구축 각 상태에 대해 하나의 변수 세트로 구축하여, 표면이 이를 사용하여 옵트인합니다. 숫자는 일반 크기의 UI를 위한 시작점입니다.
  • 밝은 유리, 어두운 텍스트 (기본값): 흰색 6–22%로 색조 (밀도에 따라 단계 4); backdrop-filter blur(2px) saturate(180%) brightness(1.06)로 배경에서 색이 나오고 탁하지 않고 선명하게 유지. 가장자리: inset 1.5px 1.5px 1px -1px white 95%, inset -1.5px -1.5px 1px -1px white 55%, inset 0 0 0 0.5px white 30%, 0 0 0 0.5px black 6%, 0 6px 24px black 8%. 내부 광택, 표면 내부 레이어: 왼쪽 상단에서 방사형 하이라이트 (흰색 30%가 55%로 희미해짐), 가장자리 바로 안쪽에 부드러운 내부 광택, 상단과 왼쪽이 더 밝고 하단은 약간 음영.
  • 밝은 모드에서 어두운 영역 위, 밝은 텍스트: rgb(16 18 22) 10–30%로 색조; 필터 blur(2px) saturate(170%) 후 brightness(0.85); 가장자리: 상단에 희미한 내부 흰색 선과 0.5px 어두운 외곽선.
  • 어두운 모드: rgb(20 20 24) 16–38%로 색조; 필터 blur(2px) saturate(160%) brightness(0.8)로 먹색으로 곱하기처럼 어두워지지 않고 적절히 어두워짐; 동일한 가장자리와 내부 광택을 약 1/3 강도로, 더 어두운 외곽선과 그림자.
  • 잉크, 고정된 단계의 하나의 색상, 유리에 그려지는 모든 항목에 사용: 밝은 유리 위 black 86% (제목, 아이콘, 시간, 진행률), rgb(60 60 67) 70% (보조); mix-blend-mode multiply; 어두운 유리 위 white 94%, rgb(235 235 245) 64%; mix-blend-mode plus-lighter. 아이콘은 불투명한 색상으로 그리고 전체 아이콘을 불투명도로 희미하게 처리: 반투명 색상은 모양의 획과 채움이 겹치는 곳에서 어두워짐.
  • 밝은 유리 위의 강조된 행은 더 밝은 유리 레이어로 표시: 호버 시 흰색 42%, 선택 시 76%, 흰색 획. 절대 회색 워시가 아님.
  • 숫자 및 색상 토큰을 @property로 등록하여 표면이 상태 사이를 갑자기 전환하지 않고 부드럽게 전환.
  1. 네 가지 선언으로 적용 각 표면은 이것들만 변경하며, 마크업은 그대로 유지:
  • background: 색조.
  • backdrop-filter: 재질의 필터, 그 다음 가장자리 렌즈 (3단계)를 마지막에 추가하여 색상 단계가 하나의 패스로 접히고 굴절이 선명하게 유지.
  • box-shadow: 가장자리.
  • color: 잉크, 내부에 그려지는 모든 것에 블렌드 모드 적용. 호버 시 그림자를 올리지 않고 색조를 약 14% 밝게.
  1. 가장자리 렌즈
  • 각 표면에 대한 변위 맵을 구축: 빨강은 측면 굴절, 초록은 수직 굴절, 128은 변화 없음. 가장자리만 굽혀지고 중앙은 평평하게 유지.
  • 가장자리는 카드의 경우 약 44px 너비 (min(44px, 짧은 변 / 3.5), 4px 미만 안 됨). 두꺼운 판의 경우 가장자리에서 거리 d인 점은 안쪽으로 1.1 × 가장자리 × (1 - d / 가장자리)^2.6만큼 보임: 가장자리에서 강하게, 장면이 자신 위로 접히는 곳, 가장자리 내부 가장자리에서 없어짐.
  • CSS가 그리는 것과 동일한 모서리에 대한 맵을 그리세요. 표면이 corner-shape: superellipse()를 사용하는 경우 원이 아닌 해당 곡선을 따라야 그렇지 않으면 모서리에서 굴절과 가장자리 광택이 어긋남.
  • SVG 필터에 feImage (맵)와 feDisplacementMap (크기 = 가장 큰 오프셋의 2배)을 사용하여 넣고 backdrop-filter 끝에 url(#id)를 추가.
  • 색상으로 분할: 세 패스, 빨강 15% 더, 파랑 15% 덜, 각각 feColorMatrix로 채널 유지 및 스크린 블렌드로 추가. 복잡한 배경 위의 넓은 가장자리 모서리 확인; 헤이즈로 바뀌는 곳에서 분할 낮춤.
  • Chromium만 backdrop-filter에서 url()을 그림. CSS.supports('backdrop-filter', 'url(#a)')로 확인하고 파싱만 하고 아무것도 그리지 않는 Firefox는 건너뜀. 다른 모든 브라우저에서는 CSS 전용 유리가 유지됨.
  • 표면이 필터를 가리키기 전에 맵 이미지가 디코딩될 때까지 기다리지 않으면 흐림 없이 그려짐. 각 필터에 고유한 id와 자체 를 부여. 반경 및 가장자리 너비당 한 번 맵을 구축하고 재사용; 크기 조정 시 맵을 재구축하지 않고 이동.
  • 32px 미만의 표면, will-change 또는 자체 합성 레이어가 있는 표면 (메뉴, 애니메이션 패널)에서는 렌즈를 건너뜀. Chrome이 굽혀진 배경 대신 맵을 그릴 수 있음.
  1. 뒤에 있는 것에 적응
  • 각 표면에 대해 5 × 3 그리드로 그 아래 배경을 샘플링하고, 가장 어두운 두 점과 가장 밝은 두 점을 제외하고 평균을 냄. 휘도는 (0.299 R + 0.587 G + 0.114 B) / 255; 질감은 가장 밝은 점에서 가장 어두운 점을 뺀 값.
  • 잉크: 밝은 모드에서 휘도가 0.5 미만이면 밝은 텍스트. 현재 잉크를 선의 ±0.05 이내로 유지하여 표면이 깜빡이지 않도록 함. 어두운 모드는 항상 밝은 텍스트. 한 행의 인접한 표면은 하나의 결정을 공유.
  • 밀도 (0 얇음, 1 조밀함) = 0.55 × 배경이 잉크 자체 밝기에 얼마나 가까운지 + 0.7 × 질감 + 0.3 × 채도. 색조를 얇은 알파와 조밀한 알파 사이로 이동.
  • 유지된 채도 = 1 - 0.75 × 채도, 최소 0.45로 선명한 배경이 유리를 얼룩지게 하지 않음.
  • 배경, 테마 또는 표면의 위치가 변경될 때 다시 샘플링하고 마지막 잉크를 기억하여 다음 로드 시 그 잉크로 열림.
  • 배경이 읽을 수 없는 이미지인 경우 (실시간 비디오, 교차 출처 콘텐츠) 테마에서 잉크를 선택하고 조밀한 색조를 사용.
  1. 사용자가 색조를 설정할 수 있도록
  • 밝은 모드용과 어두운 모드용 설정 하나씩 추가하여 색조를 0에서 1.5까지 조절 (1은 설계된 재질). 1 미만에서는 필터의 밝기 상승이 함께 얇아져서 0에서는 흐림, 가장자리 및 그림자만 남음.
  • 각 테마는 자체 값을 유지하며 테마 전환 시 해당 테마의 값으로 부드럽게 전환.
  1. 접근성 유지
  • 제품이 허용하는 가장 복잡한 배경과 가장 어두운 배경에서 기본 색조로 텍스트 대비 확인; 잉크의 불투명도가 아닌 밀도를 높여 통과할 때까지.
  • prefers-reduced-transparency 및 forced colors를 존중: 완전 불투명도에서 동일한 색조의 단색 표면으로 폴백.
  • 포커스 링, 비활성화 상태 및 오류 색상은 그대로 유지; 실패는 빨간색 유지.
  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-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-scroll-cards

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

관련 스킬