Communitygithub.com

kubai-easing-curves

Define eases and durations for UI animations by usage scenario: ease-out for entrances, ease-in for exits, ease-in-out for moves, overshoot for confirmations, spring for gesture releases. Export them as motion tokens (easing, motion curves).

O que é kubai-easing-curves?

Esta habilidade (_skill_) para agentes de IA (como Claude Code ou Cursor) auxilia no refinamento de animações de interface usando curvas de easing e durações semanticamente corretas. Ela inspeciona o código existente do projeto (CSS, Framer Motion, GSAP, API de Animações Web ou loops com requestAnimationFrame), identifica transições e animações, e as substitui por um conjunto predefinido de tokens de easing (`--ease-out`, `--ease-in`, `--ease-in-out`, `--ease-overshoot`, `--ease-spring`) e durações (`--duration-sm`, `--duration-md`, `--duration-lg`). A abordagem é baseada em papéis: entradas usam ease-out, saídas ease-in, movimentos na tela ease-in-out, confirmações pequenas usam overshoot, e gestos (drag/swipe) finalizam com spring. A habilidade preserva a intenção original da animação (o que anima, a distância e o gatilho), respeita `prefers-reduced-motion` e garante que animações nunca bloqueiem interação do usuário. O agente lista todas as animações encontradas, propõe as alterações tokenizadas e pergunta ao usuário antes de modificar animações sem uma função clara. Funciona em qualquer projeto web com sistema de design existente, garantindo consistência e acessibilidade.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Por cenário, escolha a curva de easing

999 pequenas dicas para dar mais qualidade ao seu produto Vibe · Episódio 011 · @kubai087

No projeto do usuário, faça as modificações conforme os requisitos abaixo. Os requisitos devem ser escritos na perspectiva do usuário: "I", "me", "my" referem-se ao usuário; onde estiver escrito "pergunte primeiro", pare e pergunte ao usuário antes de continuar.

Requisitos de modificação

Dê ao movimento no meu produto as curvas de easing corretas, para que as coisas cheguem, saiam e se movam da maneira que devem parecer. Trabalhe dentro do meu código e sistema de design existentes: mantenha o que cada animação faz, a distância que percorre e o que a aciona. Altere como ela se move ao longo do tempo e sua duração quando esta estiver errada.

  1. Comece pelo que já existe
  • Encontre toda transição e animação: transições e keyframes CSS, bibliotecas de animação (Framer Motion, GSAP, a API de Animações Web) e loops requestAnimationFrame escritos à mão. Liste cada uma com seu componente, seu gatilho, sua duração e sua curva.
  • Sinalize aquelas deixadas no padrão CSS ease, linear em algo que se move, e ease-in em algo que aparece.
  1. As curvas como tokens Defina-as uma vez, ao lado dos outros tokens de movimento, e use apenas estes:
  • --ease-out: cubic-bezier(0, 0, .58, 1). Qualquer coisa que entra: toasts, menus, popovers, diálogos, painéis laterais.
  • --ease-out-strong: cubic-bezier(.22, 1, .36, 1). Pequenas partes que se ajustam logo após um clique: um ícone, um rótulo, uma pílula selecionada. Parece a mais responsiva.
  • --ease-in: cubic-bezier(.42, 0, 1, 1). Qualquer coisa que sai, e apenas isso: um toast expirando, um diálogo ou painel fechando, um menu recolhendo, um item de lista deslizado para fora. Começa devagar e sai em velocidade máxima, então em uma entrada parece atrasada e para com um solavanco.
  • --ease-in-out: cubic-bezier(.42, 0, .58, 1). Algo que permanece na tela e apenas muda de lugar ou tamanho: o indicador sob abas ou um controle segmentado, um carrossel virando uma página, itens abrindo espaço durante uma reordenação, uma barra lateral redimensionando, rolagem suave até uma âncora. Não para entrada: seu início lento parece lag.
  • --ease-overshoot: cubic-bezier(.34, 1.56, .64, 1). Ultrapassa o lugar em cerca de 10% e volta. Confirmações pequenas e lúdicas: uma marca de seleção, um like, um contador de emblema surgindo, um botão de alternância se ajustando. Nunca em um diálogo, painel ou qualquer coisa maior que cerca de 64px, e não em ações que as pessoas repetem o dia todo.
  • --ease-spring: linear(0, .32, .78, 1.04, 1.09, 1.06, 1.02, 1, .99, .99, 1). Coisas soltas após um arrasto ou deslize, para que se acomodem como um objeto: uma folha inferior encaixando-se ao abrir ou voltar, um cartão retornando após meio deslize, puxar-para-atualizar voltando com elasticidade, um item reordenado caindo no lugar. Prefira a spring da própria biblioteca de animação alimentada com a velocidade de liberação; use este token apenas quando não houver tal spring, e recorra a --ease-out-strong onde linear() não for suportado.
  • linear: apenas para coisas que rodam em vez de se moverem: spinners, barras de progresso, marquees.
  • O padrão CSS ease não é uma opção. Substitua-o onde quer que uma curva tenha ficado sem definição.
  1. Durações
  • UI pequena (toasts, tooltips, menus, checks): 150–250ms na entrada, 120–200ms na saída. Saídas são mais curtas que entradas.
  • Média (diálogos, popovers com conteúdo, painéis): 250–350ms.
  • Grande ou tela cheia (folhas, transições de página): 350–500ms. Mais longo parece lento.
  • Springs e overshoots: cerca de 1,5x a duração simples, pois o ajuste leva tempo.
  • Mantenha as durações como tokens ao lado das curvas (--duration-sm, -md, -lg).
  1. Aplique por função
  • Entradas: ease-out, vindo de onde a coisa pertence (um toast da borda superior, um menu do seu gatilho), em uma curta distância (8–24px), crescendo de 96% e desvanecendo um pouco antes de se mover. Um leve desfoque (cerca de 8px) que clareia conforme aterrissa é um toque agradável em toasts.
  • Saídas: ease-in, o mesmo caminho invertido, e mais curtas.
  • Movimentos na tela: ease-in-out.
  • Partes dentro de algo que acabou de aparecer (seu ícone, seu texto, uma contagem) podem seguir 100–200ms depois no ease-out forte, para que aterrissem em etapas em vez de tudo de uma vez.
  • Gestos: enquanto o ponteiro ou dedo se move, siga-o 1:1 sem easing. Ao soltar, finalize com a spring, a partir da velocidade de liberação se a biblioteca permitir.
  • Hover e pressionar: 100–150ms ease-out. Nunca anime layout em hover.
  • Anime transform e opacity (filter com moderação), não top, left, width ou height, que recalculam layout e repintam a cada frame.
  1. Mantenha consistente e acessível
  • Uma curva por função em todo o produto. Não ajuste cada componente manualmente.
  • Respeite prefers-reduced-motion: mantenha as mudanças de opacidade, remova movimento e escala, e transforme springs e overshoots em um simples fade de 150ms.
  • Nunca faça um usuário esperar por uma animação: nada bloqueia entrada, e uma nova ação interrompe a animação antiga de onde ela está.
  1. Entregue
  • Primeiro liste cada animação encontrada, sua curva e duração atuais, e a função e curva que você dará a ela.
  • Em seguida, adicione os tokens, troque cada animação e liste cada arquivo que você tocou.
  • Não mude o que anima, a distância que percorre ou o que a aciona. Se uma animação não tiver uma função clara, pergunte-me primeiro.

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

Habilidades Relacionadas