Communitygithub.com

xzedm/clipplic-landing

用於設計、重新設計、塑造、評論、審計、打磨、釐清、提煉、強化、優化、調整、動畫化、著色、提取或以其他方式改進前端介面。涵蓋網站、登陸頁面、儀表板、產品 UI、應用程式外殼、元件、表單、設定、引導流程和空白狀態。處理 UX 審查、視覺層級、資訊架構、認知負荷、無障礙性、效能、響應式行為、主題、反模式、排版、字體、間距、佈局、對齊、色彩、動畫、微互動、UX 文案、錯誤狀態、邊緣案例、i18n 以及可重複使用的設計系統或 Token。也用於需要變得更醒目或更令人愉悅的平淡設計、需要變得低調的喧鬧設計、瀏覽器即時迭代 UI 元素,或應在技術上顯得非凡的雄心勃勃的視覺效果。不適用於僅後端或非 UI 的任務。

clipplic-landing 是什麼?

這個技能「clipplic-landing」專注於在瀏覽器環境中直接生產和迭代工業級的前端介面。它提供一套嚴格的設計規則和硬性禁令,幫助 AI 代理生成真正可出貨、可生產的程式碼,而非原型或 AI 常見的樣板設計。此技能支援多種平台(如 Claude Code、Cursor、Codex、Gemini)並附有特定平台的缺陷提醒。它涵蓋了從色彩對比度檢查、字體配對、佈局策略到動畫設計和互動模式等全方位 UX 與 UI 設計準則,並特別禁止各種 AI 生成內容的常見「AI 痕跡」(如左側條紋邊框、漸層文字、毛玻璃效果、相同的卡片網格等)。該技能會引導代理先執行初始化腳本 (`context.mjs`) 獲取專案上下文,讀取特定的子命令參考文件(如 `craft`、`audit`),並根據專案類型(品牌行銷 vs. 產品 UI)閱讀不同的設計註冊參考文件。對於全新專案它還提供顏色調色板生成和主題策略指導,確保設計有品牌識別度且不落俗套,最終產出兼具美觀、效能與可及性的高品質介面。

相容平台~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/impeccable

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

設計並迭代工業級前端介面。實際可運行的程式碼、深思熟慮的設計決策、卓越的工藝。

設定

你必須在開始之前完成以下步驟:

  1. 在每個會話中執行一次 node {{scripts_path}}/context.mjs。如果請求中指明或暗示了 monorepo 中的檔案、路由或應用程式,請推斷出具體路徑並改為執行 node {{scripts_path}}/context.mjs --target <path>。如果你已在本次對話中看過其輸出,請勿重新執行。該腳本會將專案的 PRODUCT.md(如果存在 DESIGN.md 也會一併)以 markdown 區塊的形式輸出,或者告知你缺少這些文件。請遵循其輸出內容。如果它輸出 NO_PRODUCT_MD,請先停止並遵循 reference/init.md,然後再執行任何其他操作。 如果輸出結尾包含 UPDATE_AVAILABLE 指令,請遵循它(向用戶詢問一次是否需要更新,然後繼續)。它永遠不會阻塞當前任務。
  2. 如果用戶使用了子命令(craft、shape、audit、polish……),你必須接下來閱讀 reference/<command>.md。這是強制性的。參考文件定義了命令的流程;沒有它,你會跳過用戶期望的步驟。
  3. 熟悉程式碼中任何現有的設計系統、慣例和元件。至少閱讀一個專案檔案(CSS / tokens / theme / 一個代表性的元件或頁面)。即使你在第 2 步中已加載了子命令參考,這也是必須的。 不要重新發明輪子;在現有內容可行時就使用它們,當 UX 需要改進時再進行擴展。
  4. 閱讀匹配的註冊參考文件。這是強制性的;跳過它會產生通用輸出。 如果專案是行銷型、登陸頁面、活動頁、長文內容或作品集(設計即產品),請閱讀 reference/brand.md。如果是應用程式 UI、管理後台、儀表板或工具(設計為產品服務),請閱讀 reference/product.md。按以下優先順序選擇:(1) 任務提示(「登陸頁面」 vs 「儀表板」);(2) 正在處理的介面(正在處理的頁面、檔案或路由);(3) PRODUCT.md 中的 register 欄位。
  5. 如果專案是全新的(在第 3 步中未找到現有的 CSS tokens / theme / 已提交的品牌色),請執行 node {{scripts_path}}/palette.mjs 以接收品牌種子色和構圖指導。這是你主要品牌色的錨點。根據腳本的說明,圍繞該錨點組合調色板的其餘部分(bg, surface, ink, accent, muted)。全程使用 OKLCH。僅當第 3 步在現有 tokens 中找到了已提交的品牌色時,才跳過此步驟;在這種情況下,保持品牌識別度為優先。

設計指導

產出可直接發佈、工業級的程式碼,而不是原型或起點。除非用戶要求,否則不採取任何捷徑(如有疑問,請詢問)。持續前進,直到交付完整的實現(美觀、響應式、快速、精確、無錯誤、符合品牌)。你對細節非常重視:每一個被打造的頁面、章節或元件,都將利用你可用工具(瀏覽器截圖、電腦使用等)進行實戰測試。{{model}} 有能力完成非凡的工作。不要有所保留。

通用規則

色彩

  • 驗證對比度。 正文文字與其背景的對比度必須達到 ≥4.5:1;大尺寸文字(≥18px 或粗體 ≥14px)需要 ≥3:1。佔位符文字需要相同的 4.5:1,而不是預設的暗淡灰色。最常見的失敗:在帶色調的近白色背景上使用暗淡的灰色正文。如果對比度接近臨界值,將主體顏色向黑色端加深;為了「優雅」而使用淺灰色,是 AI 設計難以閱讀的第一大原因。
  • 灰色文字在彩色背景上看起來會褪色。使用背景色本身更深色調的顏色,或文字顏色的透明度。

排版

  • 正文行長度限制在 65–75 個字符以內。
  • 不要搭配相似但不同的字體(例如,兩種幾何無襯線字體,或兩種人文無襯線字體)。應在對比軸上進行搭配(襯線 + 無襯線,幾何 + 人文),或使用同一字體家族的多種字重。
  • 英雄區 / 展示級標題上限:clamp() 的最大值 ≤ 6rem(約 96px)。超過此數值,頁面就是在「吼叫」而非「設計」。
  • 展示級標題字母間距下限:≥ -0.04em。再緊湊些,字母就會相碰;這會顯得侷促,而非「有設計感」。
  • 在 h1–h3 上使用 text-wrap: balance 以獲得均勻的行長;在長篇散文中使用 text-wrap: pretty 以減少孤行。

佈局

  • 變化間距以營造節奏感。
  • 卡片是懶惰的答案。只有在它們確實是最佳選擇時才使用。嵌套卡片永遠是錯的。
  • 1D 用 Flexbox,2D 用 Grid。不要預設使用 Grid,當 flex-wrap 更簡單時。
  • 對於無需斷點的響應式網格:repeat(auto-fit, minmax(280px, 1fr))。
  • 建立一個語義化的 z-index 層級(dropdown → sticky → modal-backdrop → modal → toast → tooltip)。永遠不要使用像 999 或 9999 這樣的隨機值。

動畫

  • 動畫應該是有意為之的,而不是事後才想到。將其視為構建的一部分。
  • 除非真正必要,否則不要對 CSS 佈局屬性進行動畫處理。
  • 使用指數曲線進行淡出(ease-out-quart / quint / expo)。不要使用彈跳或彈性效果。
  • 對於更高級的動畫需求,使用函式庫(例如 motion, gsap, anime.js, lenis 等)。
  • Reduced motion 是不可選的。每個動畫都需要一個 @media (prefers-reduced-motion: reduce) 的替代方案:通常是交叉淡入淡出或即時過渡。
  • 在同一個列表中對項目進行交錯(stagger)動畫是合理的。問題在於統一的反射動作(每個章節都應用相同的入場動畫),而不是動畫本身;每個揭示動畫都應適合它所揭示的內容。壓制反射動作永遠不是一個交付一個沒有任何動畫的頁面的理由。
  • 揭示動畫必須增強一個已經可見的默認狀態。不要將內容的可見性與類觸發的過渡綁定;過渡會在隱藏的選項卡和無頭渲染器上暫停,導致揭示動畫永遠不會觸發,從而使得該章節以空白狀態交付。
  • 高級動畫素材不僅僅是 transform/opacity。模糊、backdrop-filter、clip-path、遮罩和陰影/光暈也是調色板的一部分,當它們能顯著改善效果並保持流暢時。

互動

  • 在 overflow: hidden 或 overflow: auto 容器內使用 position: absolute 渲染的下拉菜單將被裁剪。請使用原生 <dialog> / popover API、position: fixed 或 portal 來逃脫堆疊上下文。

僅限新專案(當沒有先前工作時)

色彩與主題

  • 使用 OKLCH。
  • 奶油 / 沙色 / 米色主體背景是 2026 年飽和的人工智慧預設。 整個暖中性色帶(OKLCH L 0.84-0.97, C < 0.06, hue 40-100)無論你怎麼稱呼它,看起來都是奶油 / 沙 / 紙 / 羊皮紙。像 --paper、--cream、--sand、--bone、--flour、--linen、--parchment、--wheat、--biscuit、--ivory 這樣的 token 名稱本身就是一種特徵。如果簡報是「溫暖的、傳統的、家庭-海岸-義大利風格」或「雜誌般的溫暖」或「編輯性的克制」,千萬不要將其轉化為近白的暖色調背景;那是 AI 的作風。請選擇:(a) 一個飽和的品牌色作為主體(如赤陶色、牛血紅、深赭色、近黑色),(b) 一個色度為 0 的真正灰白色(或色度朝向品牌本身的色調,而不是默認朝向「溫暖」),或 (c) 一個明顯屬於品牌本身的深色中間調中性色。品牌的「溫暖」應由強調色、排版和圖像來承載,而不是由主體背景。
  • 有色調的中性色:添加 0.005–0.015 的色度,朝向品牌色調。不要因為「品牌感覺是那樣」就默認向暖色或冷色調色;那是跨專案單一文化的表現。
  • 選擇主題時:深色 vs. 淺色永遠不是一個默認選項。不是因為「工具看起來酷所以用深色」,也不是因為「安全所以用淺色」。在選擇之前,寫一句關於物理場景的描述:誰在使用這個、在哪裡、在什麼環境光下、以什麼心情。如果這句話無法強迫你做出選擇,那它還不夠具體。添加細節直到它能強迫你做出選擇。
  • 在選擇顏色之前,先選擇一個色彩策略。在承諾度軸線上有四個步驟:
  • 剋制:有色調的中性色 + 一個不超過 10% 的強調色。產品預設;品牌極簡主義。
  • 承諾:一個飽和色承擔 30–60% 的表面面積。品牌驅動頁面的預設。
  • 完整調色板:3–4 個命名的角色,每個都有目的地使用。品牌活動;產品資料視覺化。
  • 沉浸式:表面即是顏色本身。品牌英雄頁面、活動頁面。

絕對禁止

進行比對並拒絕。如果你正要寫出以下任何一種,請用不同的結構重寫該元素。

  • 側邊條紋邊框。 border-left 或 border-right 大於 1px 的彩色強調邊框,用於卡片、列表項、提示框或警告。永遠不是有意為之。請用完整邊框、背景色調、前導數字/圖標,或什麼都不用來重寫。
  • 漸層文字。 將 background-clip: text 與漸層背景結合使用。裝飾性,從無實際意義。請使用單一純色。通過字重或尺寸來強調。
  • 默認使用毛玻璃效果。 模糊和玻璃卡片作為裝飾使用。要麼是罕見且有目的的,要麼就完全不用。
  • 英雄指標模板。 大數字、小標籤、支援數據、漸層強調。SaaS 的陳詞濫調。
  • 相同的卡片網格。 相同尺寸的卡片,包含圖標 + 標題 + 文字,無休止地重複。
  • 每個章節上方都有 tiny 大寫追蹤的輔助文字。 2023 年時代的起頭文字(帶有寬間距的小型全部大寫文字,如每個標題上方的「關於」、「流程」、「定價」)現在已是飽和的人工智慧框架;不論簡報內容如何,它在 55-95% 的生成內容中出現,這本身就是定義性的特徵。一個作為刻意品牌系統的命名起頭文字是風格;每個章節都放一個起頭文字是 AI 的語法。請選擇不同的節奏。
  • 默認使用編號章節標記(01 / 02 / 03)作為框架。 在每個章節上方加上「01 · 關於 / 02 · 流程 / 03 · 定價」是起頭文字慣例的更深一層:因為「登陸頁面都這樣做」而使用它,你只是在按照反射進行框架搭建。數字只有在章節確實是一個序列(一個真正的三步驟流程、一個有序的流程、一個有類型的時間線)並且順序傳達了讀者需要的資訊時,才有其存在的意義。在一個頁面上有一個經過深思熟慮的編號序列是風格;在整個網站上每個章節都有編號起頭文字是 AI 的語法。
  • 溢出其容器的文字。 長標題詞彙、大的 clamp 比例以及窄的網格會導致在平板/手機上標題溢出。請在每個斷點測試標題文案;如果溢出,請減少 clamp 的最大值或重寫文案。視口是設計的一部分。
  • 在同一個元素上同時使用 border: 1px solid X 和 box-shadow: 0 Npx Mpx ... 且 M ≥ 16px。這是「幽靈卡片」模式:在按鈕和卡片上使用 1px 邊框加上柔和的寬投影。不要將它們配對。兩者中選一個(要麼是品牌色的單一實線邊框,要麼是模糊不超過 8px 的明確定義的陰影),絕不能同時使用兩者作為裝飾。
  • 在卡片/章節/輸入框上使用 border-radius: 32px+。 你過度圓角了。卡片的圓角最大為 12–16px;對標籤/按鈕使用完整的膠囊形狀沒問題。但在卡片上選擇 24/28/32/40px 是 codex 的特徵;沒有品牌想要「極度圓角」。
  • 手繪 / 塗鴉風格的 SVG 插圖。 類名如 loose-sketch、*-sketch、doodle、wavy;feTurbulence / feDisplacementMap「紙張紋理」濾鏡;旨在描繪具體主題(水獺、桌子叉子、專輯封面)的 5 到 30 條路徑的粗略場景。所有這些都顯得業餘,而非異想天開。如果你不能用真實的素材渲染場景,就不要提供插圖。不要嘗試使用塗鴉風格的 SVG 作為備選。
  • repeating-linear-gradient(...) 條紋背景。 body:before 或章節背景中的對角線條紋純粹是 codex 的裝飾。不要使用。
  • 圖示周圍的圓形背景(彩色圓形容器)。 在列表項、功能卡或章節中的每個圖示周圍加一個圓形背景(例如 bg-<color>/10 + rounded-full)現在是 codex 的模板。如果一個圖示需要容器,儀表板風格的圓角矩形背景是更中性的選擇。
  • 使用 top: X / left: Y 或 margin-left: -Xpx 將元素定位在邊界附近的視差風佈局。 這種「從邊框溢出」的裝飾,尤其當它只是微妙地部分遮擋時,是 codex 的習慣。將元素保留在它所屬的容器網格內。
  • 深色模式中的高對比度彩色強調。 在深色模式中保持對比度但不使用純色作為鏈接或按鈕,而是使用顏色 c 的色調,該色調在基於品牌色的同時也能保持清晰度,例如 reuse-accent oklch(from var(--color-brand) l c h / 0.85)

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

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)

相關技能