Communitygithub.com

xzedm/clipplic-landing

OKLCH-Farbraum und Farbverwendung für Webprojekte. Konvertiere Hex/RGB/HSL zu OKLCH, generiere Paletten, prüfe Kontraste, handhabe Gamut-Grenzen, theme mit Tailwind v4 und wende Farben mit Bedeutung an.

Was ist clipplic-landing?

Diese Skill-Definition ermöglicht es einem KI-Agenten (wie Claude Code, Cursor oder Codex), professionell mit dem OKLCH-Farbraum zu arbeiten. OKLCH ist ein wahrnehmungslinearer Farbraum, bei dem Helligkeit (Lightness), Buntheit (Chroma) und Farbton (Hue) als unabhängige und intuitive Designparameter dienen. Der Skill unterstützt Konvertierungen aus Hex, RGB und HSL, die Generierung von Farbskalen und Paletten (auch für Dark Mode), die Zugänglichkeitsprüfung nach APCA und WCAG, die Behandlung von Gamut-Grenzen (inkl. P3-Fallback) sowie die Integration mit Tailwind v4 über `@theme`. Ein zentraler Grundsatz ist die Achtung des bestehenden Farbsystems eines Projekts: Es wird nicht ohne Grund eine neue Notation eingeführt. Stattdessen werden semantische Tokens verwendet, wobei jede Farbe nur eine Bedeutung trägt. Der Skill liefert zudem ein strukturiertes Review-Format mit Schweregraden, Ortsangaben und einer abschließenden Bewertung (Block, Needs changes, Approve).

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

OKLCH-Farben

OKLCH ist ein wahrnehmungslinearer Farbraum, bei dem Helligkeit (Lightness), Buntheit (Chroma) und Farbton (Hue) nützliche Designsteuerungen sind. Verwende ihn, wenn das Projekt bereits OKLCH verwendet, wenn ein neues Farbsystem erstellt wird oder wenn der Benutzer nach Konvertierung oder Palettenarbeit fragt. Erhalte andernfalls die etablierten Tokens und Notationen des Projekts: Ein konsistentes Hex- oder RGB-Tokensystem ist besser, als eine zweite Farbdarstellung für eine isolierte Korrektur einzuführen. Für eine interaktive Erkundung besuche oklch.fyi.

Kurzreferenz

KategorieWann verwendenReferenz
KonvertierungHex/RGB/HSL zu OKLCHcolor-conversion.md
PalettenSkalen, Mehrfarbtöne, Dark Mode generierenpalette-generation.md
KontrastAPCA/WCAG-Prüfungen, Fehler melden, auf Anfrage behebenaccessibility-contrast.md
Gamut & TailwindP3-Fallback, @theme-Skalen, Gamut-Clippinggamut-and-tailwind.md
VerwendungSemantische Tokens, eine Bedeutung pro Farbe, Primäraktion-Hervorhebung, Erscheinungsvariantencolor-usage.md

Kernprinzipien

1. Wahrnehmungslinearen Farbraum verwenden

  • Das bestehende System respektieren. Notation nicht nur deshalb umwandeln, weil dieser Skill geladen wurde. Die semantischen Tokens und das Autorenformat des Projekts wiederverwenden, es sei denn, die Aufgabe umfasst eine Farbsystemmigration.
  • Wahrnehmungslineare Gleichmäßigkeit. Gleiche L-Schritte = gleiche Helligkeit. oklch(0.5 ...) ist visuell mittig. HSLs lightness: 50% variiert stark je nach Farbton.
  • Stabiler Farbton. HSL-Blau verschiebt sich bei Helligkeitsänderungen ins Violette. Der OKLCH-Farbton bleibt über den gesamten Helligkeitsbereich konstant.
  • Unabhängige Buntheit. Chroma ist ein absolutes Maß für Buntheit, das nicht von der Helligkeit abhängt. Die HSL-Sättigung tut dies.
  • Endlicher Gamut. Nicht jeder OKLCH-Wert lässt sich in einem darstellbaren sRGB-Farben abbilden. Hochchromatische Werte bei bestimmten Farbtönen werden abgeschnitten; Gamut-Bewusstsein ist erforderlich.

2. OKLCH einheitlich schreiben und formatieren

oklch(L C H)
oklch(L C H / alpha)
KanalBereichBeschreibung
L (Helligkeit)0–10 = schwarz, 1 = weiß. Wahrnehmungslinear.
C (Buntheit)0–~0.4Farbigkeit. 0 = grau. Maximalwert abhängig von L und H.
H (Farbton)0–360Farbtonwinkel in Grad.
alpha0–1Optionale Transparenz. Schrägstrich-Syntax.
oklch(0.637 0.237 25.331)
oklch(0.8 0.05 200 / 0.5)

Verwende drei Dezimalstellen für L und C und bis zu drei für H. Lasse nachfolgende Nullen weg und formatiere -0 als 0. OKLCH ist Baseline 2023; wenn die Support-Anforderungen ungewöhnlich breit sind, überprüfe die Zielprojekt-Browser-Matrix anstatt dich auf einen festen globalen Abdeckungsprozentsatz zu verlassen.

3. Kontrast, Gamut und Palettenverhalten messen

RegelWert
Hell/Dunkel-GrenzeL > 0.73 = heller Hintergrund → dunkler Text; darunter erzielt heller Text immer noch höhere Punktzahlen
Helligkeitslücke (heller Hintergrund)Vordergrund-L < 0.35 wenn Hintergrund-L > 0.9
Helligkeitslücke (dunkler Hintergrund)Vordergrund-L > 0.9 wenn Hintergrund-L < 0.25
Farbton-Drift-Schwelle> 10° Streuung über Palettenschritte = sichtbare Drift
APCA-Fließtext
APCA-Nicht-Fließtext
WCAG 2 normaler Text4.5:1 AA, 7:1 AAA
Kontrastkorrektur (nur auf Anfrage)Zuerst L anpassen; C und H nach Möglichkeit beibehalten, dann das gerenderte Paar erneut messen

Häufige Fehler

ProblemLösung
Rohe Farbe umgeht das semantische Token-System des ProjektsDen korrekten Rollen-Token in der vorhandenen Notation des Projekts wiederverwenden oder hinzufügen
Isolierter OKLCH-Wert in einer Hex/RGB-Codebasis eingeführtDie etablierte Notation beibehalten, es sei denn, die Aufgabe umfasst eine Farbsystemmigration
HSL-Palettenrampe mit Farbton-DriftMit konstantem OKLCH-Farbton neu aufbauen
Fehlgeschlagener Kontrast (Vordergrund gegen seinen Hintergrund mit APCA prüfen)Das Paar, seinen gemessenen Lc und den verfehlten Schwellenwert melden; Farben nur ändern, wenn darum gebeten wird (dann L anpassen, C und H beibehalten)
Hohe Buntheit ohne Gamut-PrüfungAuf maximale Buntheit für L/H im sRGB begrenzen
Gleiches absolutes C über verschiedene Farbtöne hinwegGleichen C% (Prozentsatz des Maximums) für konsistente Lebendigkeit verwenden
P3-Farbe ohne sRGB-Fallback@media (color-gamut: p3)-Muster hinzufügen
Dunkelmodus durch mechanisches Umkehren der hellen Palette erstelltDie helle Palette als Ausgangspunkt verwenden, dann Buntheit und Helligkeit abstimmen und jedes Vordergrund-/Hintergrundpaar erneut prüfen
Hex in Tailwind v4 @themeIn OKLCH-Werte konvertieren
Alpha mit Komma-SyntaxSchrägstrich verwenden: oklch(L C H / alpha)
Gleicher Farbton bedeutet zwei verschiedene Dinge (Linkfarbe dekorativ wiederverwendet)Eine Farbe, eine Bedeutung; der zweiten Verwendung ein Neutral geben
Semantischer Token außerhalb seiner Rolle verwendet (Trennzeichen als Text)Einen Token für die fehlende Rolle hinzufügen; niemals nach Wert ausleihen
Mehrere farbige Steuerelement-Hintergründe in einer AnsichtNur die einzelne primäre Aktion füllen; Sekundärelemente bleiben neutral
Palette nur im hellen Modus verifiziertJedes Vordergrund-/Hintergrundpaar in beiden Erscheinungsformen erneut prüfen

Ausgabeformat für Überprüfungen

Verwende dieses Format nur, wenn der Benutzer nach einer eigenständigen Farbüberprüfung fragt. Wenn better-interface die Überprüfung orchestriert, liefere Domänennachweise und Ergebnisse an diesen Skill und lasse sein Ausgabeformat, seine Schweregradskala, seine Zusammenfassungsregeln, die Höchstzahl und das Urteil den Vorrang haben.

Präsentiere die eigenständige Überprüfung in zwei Teilen.

Ergebnisse

Gruppiere alle bestätigten Ergebnisse nach Prinzip. Verwende eine Markdown-Tabelle mit Schweregrad, Ort, Vorher, Nachher und Warum-Spalten. Verwende niemals separate „Vorher:“ / „Nachher:“-Zeilen.

  • Schweregrad: HIGH macht Inhalt unlesbar oder weist eine irreführende semantische Farbe zu; MEDIUM erzeugt einen spürbaren Theme-, Gamut- oder Konsistenzfehler; LOW ist isolierte Politur.
  • Ort: zitiere pfad/zu/datei:zeile. Wenn das Artefakt keine Quelldateien hat, zitiere stattdessen den genauen Bildschirm und die Komponente.
  • Vorher / Nachher: Zeige den aktuellen Wert oder Token und den genauen Ersatz.
  • Warum: Nenne das verletzte Prinzip und füge gemessene Kontrast- oder Gamut-Nachweise bei, wenn relevant.

Fasse ein wiederholtes systemisches Problem in einer Zeile zusammen und liste jeden betroffenen Ort auf. Lasse Prinzipien ohne Ergebnisse weg.

SchweregradOrtVorherNachherWarum
MEDIUMsrc/theme.css:18color: #3b82f6color: oklch(0.623 0.188 259.815)Neue Projektfarben verwenden OKLCH-Tokens
MEDIUMsrc/palette.ts:31Gleiches absolutes C über Farbtöne hinwegGleicher C% des maximalen Chromas jedes FarbtonsGleiche Buntheitswerte erscheinen nicht über Farbtöne hinweg gleich lebendig
HIGHsrc/theme.css:52P3-Farbe ohne FallbacksRGB-Fallback vor @media (color-gamut: p3) hinzugefügtDie Farbe funktioniert auf nicht-P3-Displays nicht

Verifizierung und Urteil

Nach den Ergebnissen:

  1. Verifizierung: Liste die genauen durchgeführten Prüfungen und ihre beobachteten Ergebnisse auf, einschließlich Kontrastmessungen, Gamut-Prüfungen sowie sowohl helle als auch dunkle Erscheinungsformen, wenn zutreffend. Wenn eine Prüfung nicht durchgeführt wurde, gib an, was noch verifiziert werden muss.
  2. Urteil: Block, wenn ein HIGH-Ergebnis verbleibt, Änderung erforderlich, wenn nur MEDIUM- oder LOW-Ergebnisse verbleiben, und Genehmigen nur, wenn keine umsetzbaren Ergebnisse mehr vorhanden sind.

Wenn es keine Ergebnisse gibt, lasse die Tabelle weg, gib an „Keine umsetzbaren Farbergebnisse“, melde die Verifizierung und beende mit Genehmigen.

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.

Verwandte Skills