Communitygithub.com

kubai-liquid-glass

Añade el material de vidrio líquido a tarjetas y paneles sobre imágenes, fondos de pantalla o vídeos: desenfoque de fondo y brillo, refracción y dispersión en los bordes, coloración y color de texto que se adaptan automáticamente al fondo, texto legible tanto en modo claro como oscuro, y el diseño permanece intacto (liquid glass, glassmorphism).

¿Qué es kubai-liquid-glass?

Este skill transforma cualquier superficie de la interfaz de usuario (tarjetas, reproductores, barras de búsqueda, menús, paneles, etc.) que se encuentre sobre imágenes, fondos de pantalla, vídeos o fondos con mucho detalle, aplicándoles un material de vidrio líquido. En lugar de un simple efecto de desenfoque, el vidrio se comporta como una losa gruesa que toma su color del escenario subyacente, adaptando su tonalidad, densidad y color de texto según el fondo. El skill genera un conjunto de variables CSS (tokens) por estado (claro/oscuro, texto claro/oscuro) que las superficies utilizan para optar al efecto, y emplea un filtro SVG para crear un bisel de refracción y dispersión cromática en los bordes, manteniendo el diseño y la maquetación originales. Soporta modo claro y oscuro, respeta las preferencias de accesibilidad y se integra con el sistema de diseño existente del usuario, permitiendo además un control fino sobre la intensidad del tinte. Funciona principalmente en navegadores basados en Chromium y degrada elegantemente en otros.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-liquid-glass

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Vidrio Líquido

999 pequeños trucos para dar más calidad a tu producto Vibe · N.º 010 · @kubai087

En el proyecto del usuario, realiza las modificaciones según las siguientes instrucciones. Redacta las instrucciones en primera persona: "I", "me", "my" se refieren al usuario; donde dice "pregunta primero", detente y pregunta al usuario antes de continuar.

Requisitos de la transformación

Aplica a las tarjetas y paneles de mi producto un material de vidrio líquido: un vidrio transparente que toma su color de la escena que tiene detrás, se lee como una losa gruesa en el borde, se adapta a lo que hay detrás y mantiene su texto legible en modo claro y oscuro. Trabaja dentro de mi sistema de diseño existente. Esto es un cambio de superficie, no de diseño: mantén mi marcado, espaciado, radios, fuentes, iconos y contenido.

  1. Parte de lo que ya existe

    • Encuentra todas las superficies que se sitúan sobre una imagen, fondo de pantalla, vídeo o un fondo con mucho detalle: tarjetas, reproductores, barras de búsqueda, barras de herramientas, menús, popovers, toasts. Enumérelas con su componente y su ubicación.
    • Averigua cómo cambia el producto entre modo claro y oscuro, y dónde residen sus tokens de color. El vidrio se aplica a esos tokens, no a cada componente.
    • Deja intactas las superficies sobre un fondo liso; el vidrio sobre un color plano solo se ve gris.
  2. El material como tokens Créalo como un conjunto de variables por estado, de modo que una superficie se adhiera al efecto usándolos. Los números son un punto de partida para una interfaz de usuario de tamaño normal.

    • Vidrio claro, texto oscuro (el predeterminado): tinte blanco al 6-22% (por densidad, paso 4); desenfoque de fondo filter: blur(2px) saturate(180%) brightness(1.06), para que el color provenga de atrás y se mantenga vivo en lugar de lechoso. Borde: 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%. Luz interior, en una capa dentro de la superficie: un destello radial desde la esquina superior izquierda (blanco 30% que se desvanece al 55%), y brillos suaves incrustados justo dentro del borde, más brillantes en la parte superior e izquierda, una pequeña sombra en la inferior.
    • Modo claro sobre un área oscura, texto claro: tinte rgb(16 18 22) al 10-30%; filtro blur(2px) saturate(170%), luego brightness(0.85); borde: una tenue línea blanca incrustada en la parte superior y un contorno oscuro de 0.5px.
    • Modo oscuro: tinte rgb(20 20 24) al 16-38%; filtro blur(2px) saturate(160%) brightness(0.8), que oscurece como una multiplicación con negro en lugar de volverse turbio; el mismo borde y luz interior aproximadamente a un tercio de su intensidad, con un contorno y sombra más oscuros.
    • Tinta, un color en pasos fijos, utilizado para todo lo dibujado sobre el vidrio:
      • Sobre vidrio claro: negro al 86% (títulos, iconos, horas, progreso), rgb(60 60 67) al 70% (secundario); mix-blend-mode: multiply.
      • Sobre vidrio oscuro: blanco al 94%, rgb(235 235 245) al 64%; mix-blend-mode: plus-lighter.
      • Dibuja los iconos en el color opaco y desvanece todo el icono con opacidad: un color translúcido oscurece donde se superponen los trazos y rellenos de una forma.
    • Una fila resaltada sobre vidrio claro es una capa más clara del vidrio: blanco 42% al pasar el ratón, 76% cuando está seleccionada, con un borde blanco. Nunca un lavado gris.
    • Registra los tokens numéricos y de color con @property para que una superficie se deslice entre estados en lugar de saltar.
  3. Aplícalo en cuatro declaraciones Cada superficie cambia solo estas, y su marcado permanece como está:

    • background: el tinte.
    • backdrop-filter: el filtro del material, luego la lente del borde (paso 3) al final, para que los pasos de color se combinen en una sola pasada y la curvatura se mantenga nítida.
    • box-shadow: el borde.
    • color: la tinta, con el modo de mezcla en todo lo dibujado dentro. Al pasar el ratón, el tinte se aclara aproximadamente un 14% en lugar de levantar una sombra.
  4. La lente del borde

    • Construye un mapa de desplazamiento para cada superficie: rojo es la curvatura lateral, verde la vertical; 128 es ninguno. Solo un borde se curva; el centro permanece plano.
    • El borde tiene aproximadamente 44px de ancho en una tarjeta (min(44px, lado_corto / 3.5), nunca menos de 4px). Para una losa gruesa, un punto d desde el borde se desplaza hacia adentro por 1.1 × borde × (1 - d / borde)^2.6: duro en el borde, donde la escena se pliega sobre sí misma, disminuyendo hasta nada en el borde interior del borde.
    • Dibuja el mapa para la misma esquina que dibuja CSS. Si la superficie usa corner-shape: superellipse(), sigue esa curva, no un círculo, o la curvatura y la luz del borde se desincronizan en las esquinas.
    • Colócalo en un filtro SVG con feImage (el mapa) y feDisplacementMap (escala = 2 × el desplazamiento más grande), y añade url(#id) al final de backdrop-filter.
    • Divídelo en colores: tres pasadas, rojo 15% más lejos y azul 15% menos, cada uno mantenido en su canal con feColorMatrix y sumado de nuevo con mezclas de pantalla. Verifica las esquinas de bordes anchos sobre fondos con mucho detalle; reduce la división donde se convierta en una neblina.
    • Solo Chromium renderiza url() en backdrop-filter. Verifica CSS.supports('backdrop-filter', 'url(#a)') y salta Firefox, que lo analiza y no dibuja nada. En todos los demás navegadores, el vidrio solo con CSS permanece.
    • Espera a que la imagen del mapa se decodifique antes de apuntar una superficie al filtro, o se dibujará sin su desenfoque. Dale a cada filtro un id único y su propio <svg>. Construye los mapas una vez por radio y ancho de borde y reutilízalos; al redimensionar, mueve el mapa, no lo reconstruyas.
    • Omite la lente en superficies de menos de 32px, y en superficies con will-change o su propia capa de composición (menús, paneles animados), donde Chrome puede dibujar el mapa en lugar del fondo curvado.
  5. Adáptate a lo que hay detrás

    • Para cada superficie, muestrea el fondo debajo de ella en una cuadrícula de 5 × 3, descarta los dos puntos más oscuros y los dos más brillantes, y promedia. La luminancia es (0.299 R + 0.587 G + 0.114 B) / 255; la textura es el punto más brillante menos el más oscuro.
    • Tinta: en modo claro, texto claro cuando la luminancia es menor de 0.5. Mantén la tinta actual dentro de ±0.05 de la línea para que una superficie nunca parpadee. El modo oscuro siempre es texto claro. Las superficies vecinas en una misma fila comparten una decisión.
    • Densidad (0 fino, 1 denso) = 0.55 × qué tan cerca está el fondo del brillo propio de la tinta + 0.7 × textura + 0.3 × croma. Mueve el tinte entre su alfa fino y denso.
    • Saturación mantenida = 1 - 0.75 × croma, al menos 0.45, para que un fondo vívido no manche el vidrio.
    • Vuelve a muestrear cuando el fondo, el tema o la posición de una superficie cambien, y recuerda la última tinta para que la próxima carga la use.
    • Si el fondo no es una imagen que se pueda leer (vídeo en directo, contenido de origen cruzado), toma la tinta del tema y usa el tinte denso.
  6. Permite que la gente ajuste el tinte

    • Añade un ajuste para modo claro y otro para modo oscuro que escalen el tinte, de 0 a 1.5 (1 es el material según el diseño). Por debajo de 1, el aumento de brillo en el filtro se reduce con él, de modo que en 0 solo quedan el desenfoque, el borde y la sombra.
    • Cada tema mantiene su propio valor; al cambiar de tema, se desliza hacia el valor de ese tema.
  7. Mantenlo accesible

    • Verifica el contraste del texto en el fondo más recargado y en el más oscuro que permita el producto, con el tinte predeterminado; aumenta la densidad, no la opacidad de la tinta, hasta que pase la prueba.
    • Respeta prefers-reduced-transparency y forced colors: retrocede a una superficie sólida del mismo tinte con opacidad total.
    • Mantén los anillos de enfoque, estados deshabilitados y colores de error tal como están; los errores mantienen su rojo.
  8. Entrega

    • Primero enumera las superficies que cambiarás, cuáles tienen la lente y la división de color, y cuáles dejas sólidas y por qué.
    • Luego añade los tokens, el helper de la lente y los dos ajustes, cambia las superficies y enumera cada archivo que hayas modificado.
    • No cambies el diseño, las fuentes, los radios ni el contenido. Si una superficie necesitara un nuevo componente para funcionar como vidrio, detente y pregúntame primero.

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

Skills relacionados