Communitygithub.com

xzedm/clipplic-landing

Espaço de cores OKLCH e uso de cores para projetos web. Converta hex/rgb/hsl para oklch, gere paletas, verifique contraste, lide com limites de gama, crie temas com Tailwind v4 e aplique cores com significado.

O que é clipplic-landing?

Esta skill fornece uma base completa para trabalhar com o espaço de cores perceptualmente uniforme OKLCH em projetos web. Ela cobre conversão de formatos legados (hex, RGB, HSL) para OKLCH, geração de paletas de cores perceptualmente uniformes (incluindo paletas multi-tom e para modo escuro), verificação de contraste usando os padrões APCA e WCAG, tratamento de limites de gama (com fallbacks para sRGB e P3), integração com Tailwind v4 via `@theme`, e boas práticas de uso de cores com tokens semânticos e significado consistente. A skill suporta principalmente agentes de IA como Claude Code, Cursor e Codex, e se baseia em princípios bem definidos: respeitar o sistema de tokens existente do projeto, usar OKLCH apenas quando apropriado (ou quando solicitado), medir contraste e gama com precisão, e evitar erros comuns como drift de matiz, saturação inconsistente entre matizes, ou introdução isolada de OKLCH em bases de código hex/RGB. Ela também define um formato de revisão de cores com severidade, localização, antes/depois e justificativa, culminando em um veredito (Bloqueio, Necessita alterações, Aprovar).

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

Perguntar na sua IA favorita

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

Documentação

Cores OKLCH

OKLCH é um espaço de cor perceptualmente uniforme onde luminosidade, croma e matiz são controles de design úteis. Use-o quando o projeto já utiliza OKLCH, ao criar um novo sistema de cores, ou quando o usuário solicitar conversão ou trabalho com paletas. Caso contrário, preserve os tokens e a notação estabelecidos do projeto: um sistema consistente de tokens hex ou RGB é melhor do que introduzir uma segunda representação de cor para uma correção isolada. Para explorar interativamente, visite oklch.fyi.

Referência Rápida

CategoriaQuando usarReferência
ConversãoHex/rgb/hsl para oklchcolor-conversion.md
PaletasGerar escalas, multi-matiz, modo escuropalette-generation.md
ContrasteVerificações APCA/WCAG, relatar falhas, corrigir quando solicitadoaccessibility-contrast.md
Gama e TailwindFallbacks P3, escalas @theme, limitação de gamagamut-and-tailwind.md
UsoTokens semânticos, um significado por cor, ênfase em ação primária, variantes de aparênciacolor-usage.md

Princípios Fundamentais

1. Use um Espaço de Cor Perceptual

  • Respeite o sistema existente. Não converta notação apenas porque esta skill foi carregada. Reutilize os tokens semânticos e o formato de autoria do projeto, a menos que a tarefa inclua uma migração de sistema de cores.
  • Uniformidade perceptual. Passos iguais em L = brilho igual. oklch(0.5 ...) é visualmente médio. A lightness: 50% do HSL varia drasticamente conforme o matiz.
  • Matiz estável. O azul do HSL tende ao roxo conforme a luminosidade muda. O matiz do OKLCH permanece constante em toda a faixa de luminosidade.
  • Croma independente. Croma é uma medida absoluta de colorido que não depende da luminosidade. A saturação do HSL depende.
  • Gama finito. Nem todo valor oklch mapeia para uma cor sRGB exibível. Valores de croma alto em certos matizes serão cortados; é necessário ter consciência de gama.

2. Escreva e Formate OKLCH de Forma Consistente

oklch(L C H)
oklch(L C H / alpha)
CanalFaixaDescrição
L (Luminosidade)0–10 = preto, 1 = branco. Perceptualmente uniforme.
C (Croma)0–~0.4Colorido. 0 = cinza. Máximo depende de L e H.
H (Matiz)0–360Ângulo do matiz em graus.
alpha0–1Transparência opcional. Sintaxe com barra.
oklch(0.637 0.237 25.331)
oklch(0.8 0.05 200 / 0.5)

Use três casas decimais para L e C e até três para H. Elimine zeros à direita e formate -0 como 0. OKLCH é Baseline 2023; quando os requisitos de suporte forem excepcionalmente amplos, verifique a matriz de navegadores do projeto alvo em vez de confiar em uma porcentagem fixa de cobertura global.

3. Meça Contraste, Gama e Comportamento de Paleta

RegraValor
Limite claro/escuroL > 0.73 = fundo claro → texto escuro; abaixo disso, texto claro ainda pontua mais
Diferença de luminosidade (fundo claro)L do primeiro plano < 0.35 quando L do fundo > 0.9
Diferença de luminosidade (fundo escuro)L do primeiro plano > 0.9 quando L do fundo < 0.25
Limite de drift de matiz> 10° de dispersão entre os passos da paleta = drift visível
APCA texto corpo|Lc| >= 75 mínimo, >= 90 preferido
APCA texto não corpo|Lc| >= 60 mínimo
WCAG 2 texto normal4.5:1 AA, 7:1 AAA
Correção de contraste (apenas quando solicitado)Ajuste L primeiro; preserve C e H quando possível, meça novamente o par renderizado

Erros Comuns

ProblemaCorreção
Cor bruta ignora o sistema de tokens semânticos do projetoReutilize ou adicione o token de função correto na notação existente do projeto
Valor OKLCH isolado introduzido em uma base de código hex/RGBPreserve a notação estabelecida, a menos que a tarefa inclua uma migração de sistema de cores
Rampa de paleta HSL com drift de matizReconstrua com matiz oklch constante
Contraste insuficiente (verifique o primeiro plano contra seu fundo usando APCA)Relate o par, seu Lc medido e o limite que ele não atinge; altere cores apenas quando solicitado (então ajuste L, mantenha C e H)
Croma alto sem verificação de gamaLimite ao croma máximo para o L/H em sRGB
Mesmo C absoluto em matizes diferentesUse a mesma % de C (percentual do máximo) para vividez consistente
Cor P3 sem fallback sRGBAdicione o padrão @media (color-gamut: p3)
Modo escuro criado invertendo mecanicamente a paleta claraUse a paleta clara como ponto de partida, depois ajuste croma e luminosidade e verifique novamente cada par primeiro plano/fundo
Hex no @theme do Tailwind v4Converta para valores oklch
Alfa com sintaxe de vírgulaUse barra: oklch(L C H / alpha)
Mesmo matiz significa duas coisas diferentes (cor de link reutilizada decorativamente)Uma cor, um significado; dê ao segundo uso um neutro
Token semântico usado fora de sua função (separador como texto)Adicione um token para a função ausente; nunca pegue emprestado por valor
Vários fundos de controle coloridos em uma visualizaçãoPreencha apenas a única ação primária; secundários permanecem neutros
Paleta verificada apenas no modo claroVerifique novamente cada par primeiro plano/fundo em ambas as aparências

Formato de Saída de Revisão

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

Apresente a revisão independente em duas partes.

Descobertas

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

  • Gravidade: ALTA torna o conteúdo ilegível ou atribui uma cor semântica enganosa; MÉDIA cria uma falha perceptível de tema, gama ou consistência; BAIXA é um polimento isolado.
  • Localização: cite caminho/para/arquivo:linha. Se o artefato não tiver arquivos fonte, cite a tela e o componente exatos.
  • Antes / Depois: mostre o valor ou token atual e a substituição exata.
  • Porquê: nomeie o princípio violado e inclua evidências de contraste ou gama medidas quando relevante.

Consolide um problema sistêmico repetido em uma linha e liste cada localização afetada. Omita princípios sem descobertas.

GravidadeLocalizaçãoAntesDepoisPorquê
MÉDIAsrc/theme.css:18color: #3b82f6color: oklch(0.623 0.188 259.815)Novas cores do projeto usam tokens OKLCH
MÉDIAsrc/palette.ts:31Mesmo C absoluto entre matizesMesma % de C do croma máximo de cada matizValores de croma iguais não parecem igualmente vívidos entre matizes
ALTAsrc/theme.css:52Cor P3 sem fallbackAdicione um fallback sRGB antes de @media (color-gamut: p3)A cor falha em monitores não P3

Verificação e Veredito

Após as descobertas:

  1. Verificação: liste as verificações exatas realizadas e seus resultados observados, incluindo medições de contraste, verificações de gama e ambas as aparências clara e escura quando aplicável. Se uma verificação não foi realizada, declare o que ainda precisa ser verificado.
  2. Veredito: Bloqueio se alguma descoberta ALTA permanecer, Necessita alterações se apenas descobertas MÉDIA ou BAIXA permanecerem, e Aprovar apenas quando nenhuma descoberta acionável permanecer.

Quando não houver descobertas, omita a tabela, declare "Nenhuma descoberta de cor acionável", relate 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

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

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

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