Communitygithub.com

xzedm/clipplic-landing

Princípios de engenharia de design para tornar interfaces polidas. Use ao construir componentes de UI, revisar código frontend, implementar animações, estados de hover, sombras, bordas, microinterações, animações de entrada/saída, escolher ou revisar ícones, ou qualquer trabalho de detalhe visual. Dispara em polimento de UI, detalhes de design, 'melhorar a sensação', 'parece estranho', animações escalonadas, raio de borda, alinhamento óptico, contornos de imagem, sombras de caixa, ícones, peso do traço do ícone, estados de ícone, contenção de movimento.

O que é clipplic-landing?

Este skill, **xzedm/clipplic-landing**, é um guia abrangente de princípios de engenharia de design para desenvolvedores que desejam criar interfaces com sensação refinada e profissional. Ele consolida dezenas de pequenos detalhes — como raio de borda concêntrico, alinhamento óptico, animações interrompíveis, sombras para elevação em vez de bordas, animações de ícones contextuais, contornos de imagem sutis e escala ao pressionar — que, quando combinados, transformam uma interface funcional em uma experiência agradável. O skill é acionado automaticamente quando o usuário pede polimento de UI, menciona que algo 'parece estranho', ou está trabalhando com animações, ícones, sombras ou qualquer detalhe visual. Ele oferece uma referência rápida por categoria (superfícies, animações, ícones, desempenho), explica cada princípio em detalhe com valores exatos (ex.: escala 0.96 ao pressionar, blur de 4px a 0px), e fornece um formato de revisão estruturado com tabelas de achados, verificação e veredito. O skill também se integra com outros skills especializados (tipografia, acessibilidade, layout) para cobertura completa sem duplicação. É compatível com qualquer framework frontend (React, Vue, etc.) e bibliotecas de animação como framer-motion, e enfatiza contenção de movimento e feedback não apenas visual.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/better-ui

Perguntar na sua IA favorita

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

Documentação

Detalhes que tornam as interfaces melhores

Grandes interfaces raramente vêm de uma única coisa. Geralmente é uma coleção de pequenos detalhes que se acumulam em uma ótima experiência. Aplique estes princípios ao construir ou revisar código de UI.

Ao revisar, desacelere a interface: reproduza a animação a 10% da velocidade no painel de Animações do navegador e percorra cada estado: hover, foco, ativo, carregamento, vazio. O que parece estranho a 10% da velocidade é o que está sutilmente errado em velocidade total.

Preserve a biblioteca de componentes, tokens e densidade do projeto. Corresponda à linguagem de movimento estabelecida, exceto onde um princípio abaixo prescreve um padrão de interação exato.

Tipografia (quebra de texto, renderização de fonte, números tabulares, espaçamento) é coberta pelo skill better-typography; use-o para qualquer coisa relacionada a texto. Acessibilidade (áreas de toque, estados de foco, suporte a teclado, ARIA, movimento reduzido) é coberta pelo skill better-accessibility. Estrutura de layout (agrupamento, espaçamento entre seções, breakpoints, RTL espacial) é coberta pelo skill better-layout.

Referência Rápida

CategoriaQuando Usar
SuperfíciesRaio de borda, alinhamento óptico, sombras, contornos de imagem
AnimaçõesAnimações interrompíveis, transições de entrada/saída, animações de ícones, escala ao pressionar, contenção de movimento
ÍconesPeso do traço do ícone, estados via currentColor, contorno vs preenchimento, dimensionamento, espelhamento RTL
DesempenhoEspecificidade de transição, uso de will-change

Princípios Centrais

1. Raio de Borda Concêntrico

Raio externo = raio interno + padding. Raios incompatíveis em elementos aninhados é a coisa mais comum que faz as interfaces parecerem estranhas.

2. Alinhamento Óptico sobre Geométrico

Quando o centralização geométrica parece estranha, alinhe opticamente. Botões com ícones, triângulos de reprodução e ícones assimétricos precisam de ajuste manual.

3. Sombras para Elevação, Bordas para Estrutura

Para botões, cards e contêineres cuja borda existe apenas para criar profundidade, prefira valores de box-shadow transparentes em camadas. Mantenha bordas que comunicam estrutura ou estado: divisores, separadores de layout e estados selecionados ou de foco.

4. Animações Interrompíveis

Use transições CSS para mudanças de estado interativas: elas podem ser interrompidas no meio da animação. Reserve keyframes para sequências encenadas que são executadas uma vez.

5. Dividir e Escalonar Animações de Entrada

Para uma entrada encenada pouco frequente onde a sequência ajuda a comunicar hierarquia, divida o conteúdo em blocos semânticos e os escale com ~100ms de diferença em vez de animar um contêiner. Não escale interações rotineiras e de alta frequência.

6. Animações de Saída Sutil

Use um pequeno translateY fixo em vez de altura total. As saídas devem ser mais suaves que as entradas. Use ease-out para transições de entrada e saída.

7. Animações de Ícones Contextuais

Anime ícones com opacity, scale e blur em vez de alternar visibilidade. Use exatamente estes valores: escala de 0.25 a 1, opacidade de 0 a 1, blur de 4px a 0px. Se o projeto tiver motion ou framer-motion no package.json, corresponda ao caminho de importação desse pacote (ou as importações próximas estabelecidas quando ambos existirem) e use transition: { type: "spring", duration: 0.3, bounce: 0 }; bounce deve ser sempre 0. Se nenhuma biblioteca de movimento estiver instalada, mantenha ambos os ícones no DOM (um posicionado absolutamente) e faça cross-fade com transições CSS usando cubic-bezier(0.2, 0, 0, 1); isso fornece animações de entrada e saída sem qualquer dependência.

8. Contornos de Imagem

Adicione um contorno sutil de 1px com baixa opacidade às imagens para profundidade consistente. A cor deve ser preto puro no modo claro (oklch(0 0 0 / 0.1)) e branco puro no modo escuro (oklch(1 0 0 / 0.1)), nunca um quase preto como slate, zinco ou qualquer neutro matizado. Um contorno matizado capta a cor da superfície abaixo e parece sujeira na borda da imagem.

9. Escala ao Pressionar

Um sutil scale(0.96) ao clicar dá feedback tátil aos botões. Sempre use 0.96. Nunca use um valor menor que 0.95: qualquer coisa abaixo parece exagerada. Adicione uma prop static para desabilitá-lo quando o movimento for perturbador.

10. Pular Animação no Carregamento da Página

Use initial={false} no AnimatePresence para evitar animações de entrada na primeira renderização. Verifique se não quebra animações de entrada intencionais.

11. Nunca Use transition: all

Sempre especifique propriedades exatas: transition-property: scale, opacity. O transition-transform do Tailwind cobre transform, translate, scale, rotate.

12. Use will-change com Moderação

Apenas para transform, opacity, filter, as propriedades que a GPU pode compor. Nunca use will-change: all. Adicione apenas quando notar trepidação no primeiro quadro.

13. Corresponder Peso do Traço do Ícone ao Peso do Texto

Um ícone ao lado de texto carrega o peso óptico do texto: traço de 1.5px ao lado de texto regular (400), 2px ao lado de semibold (600). Um peso de traço por conjunto de ícones; nunca misture bibliotecas em uma superfície.

14. Um SVG, Recolorido por Estado

Ícones usam currentColor e obtêm seus estados (hover, selecionado, desabilitado) de cor e opacidade CSS, nunca de assets separados. A variante de contorno é o padrão; a variante de preenchimento marca o estado ativo.

15. Contenção de Movimento

Nenhuma animação personalizada em interações de alta frequência: o custo de atenção se repete a cada acionador. Movimento nunca é o único canal de feedback; toda mudança de estado animada também precisa de uma dica estática (cor, ícone, rótulo).

Erros Comuns

ErroCorreção
Mesmo raio de borda em pai e filho muito aninhadosCalcule raioExterno = raioInterno + padding
Ícones parecem descentralizadosAjuste opticamente com padding ou corrija o SVG diretamente
Borda usada apenas para simular elevaçãoUse box-shadow em camadas com transparência; mantenha bordas estruturais e de estado
Entrada encenada ou saída contextual bruscaEscalone entradas pouco frequentes e mantenha saídas contextuais sutis
Ícone com estado ou alternância anima seu estado padrão no carregamento da páginaAdicione initial={false} ao AnimatePresence correspondente; preserve entradas de página intencionais
transition: all em elementosEspecifique propriedades exatas
Trepidação de animação no primeiro quadroAdicione will-change: transform (com moderação)
Ícone de traço fino ao lado de texto em negritoCorresponda a largura do traço ao peso do texto
Assets de ícone separados por estadoUm SVG com currentColor, estados via CSS
Ícones preenchidos em todos os lugaresContorno como padrão, preenchimento apenas para o estado ativo
Animação de entrada em cada hover ou teclaFeedback instantâneo ou transição de opacidade/cor de ≤150ms

Formato de Saída da Revisão

Use este formato apenas quando o usuário solicitar uma revisão independente de polimento de UI. Quando better-interface orquestrar a revisão, forneça evidências de domínio e descobertas para esse skill e deixe que seu formato de saída, escala de gravidade, regras de consolidação, limite e veredito tenham precedência.

Apresente a revisão independente em duas partes.

Descobertas

Agrupe todas as descobertas confirmadas por princípio. Use uma tabela markdown com colunas Gravidade, Localização, Antes, Depois e Por quê. Nunca use linhas separadas "Antes:" / "Depois:".

  • Gravidade: HIGH torna uma interação enganosa, sem resposta ou repetidamente perturbadora; MEDIUM cria um problema perceptível de acabamento ou consistência; LOW é polimento isolado.
  • Localização: cite caminho/para/arquivo:linha. Se o artefato não tiver arquivos de origem, cite a tela e o componente exatos.
  • Antes / Depois: mostre a implementação atual e uma substituição acionável.
  • Por quê: nomeie o princípio violado e explique como ele afeta a interface.

Consolide um problema sistêmico repetido em uma linha e liste todos os locais afetados. Omita princípios sem descobertas.

Exemplo

Raio de borda concêntrico

GravidadeLocalizaçãoAntesDepoisPor quê
LOWsrc/Card.tsx:28rounded-xl no card + rounded-xl no botão interno (p-2)rounded-2xl no card (8 + 8 = 16), rounded-lg no botão internoCantos aninhados devem ser concêntricos
LOWsrc/card.css:11border-radius: 16px em ambas as superfícies aninhadasExterna 24px, interna 16px com 8px de paddingRaios aninhados iguais fazem a superfície interna parecer comprimida

Escala ao pressionar

GravidadeLocalizaçãoAntesDepoisPor quê
LOWsrc/Button.tsx:19<button className="...">Adicione active:scale-[0.96] transition-transformFeedback de pressionar torna o controle responsivo
MEDIUMsrc/button.css:24scale(0.9) ao pressionarAumente para scale(0.96)Qualquer valor abaixo de 0.95 parece exagerado

Verificação e Veredito

Após as descobertas:

  1. Verificação: liste as verificações exatas executadas e seus resultados observados. Percorra cada estado relevante e inspecione o movimento a 10% da velocidade quando a animação estiver envolvida. Se uma verificação não foi executada, declare o que ainda precisa de verificação.
  2. Veredito: Bloquear se qualquer descoberta HIGH permanecer, Precisa de mudanças se apenas descobertas MEDIUM ou LOW permanecerem, e Aprovar apenas quando nenhuma descoberta acionável permanecer.

Quando não houver descobertas, omita as tabelas, declare "Nenhuma descoberta acionável de polimento de UI", reporte a verificação e termine com Aprovar.

Individual skills in this repo

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

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

xzedm/clipplic-landing

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic. A promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Habilidades Relacionadas