Communitygithub.com

xzedm/clipplic-landing

設計工程原則,讓介面更精緻。用於建構 UI 元件、審查前端程式碼、實作動畫、懸停狀態、陰影、邊框、微互動、進出場動畫、選擇或審查圖示,以及任何視覺細節工作。

clipplic-landing 是什麼?

這個 AI 代理技能(名為「xzedm/clipplic-landing」)專注於讓介面感覺更精緻的設計工程原則。它能在開發者建構 UI 元件、審查前端程式碼、實作動畫、懸停效果、陰影、邊框、微互動、進出場動畫,以及選擇或審查圖示時被觸發。此技能會引導 AI 代理應用一套核心原則,包含同心圓邊框半徑、光學對齊、用於高度層級的陰影、可中斷動畫、交錯進場與淡出動畫、按壓縮放效果,以及圖示動畫等。更重要的是,它會記住要避免常見錯誤,例如對所有屬性使用 `transition: all` 或濫用 `will-change`。在審查模式下,此技能能產出結構化報告,根據原則分類問題、標示嚴重性,並給出最終的審核結果(封鎖、需要修改、或核准)。它支援任何使用 CSS、Tailwind CSS、Framer Motion 或類似 UI 函式庫的專案。

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

在你喜歡的 AI 中提問

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

說明文件

讓介面感覺更好的細節

出色的介面很少來自單一元素。通常是一系列小細節的疊加,造就了卓越的體驗。在建構或審查 UI 程式碼時應用這些原則。

審查時,放慢介面速度:在瀏覽器的「動畫」面板中以 10% 的速度重播動畫,並逐一檢查每個狀態:懸停、聚焦、啟用、載入、空白。在 10% 速度下感覺不對勁的地方,就是全速時細微錯誤的所在。

保留專案的元件庫、設計代碼和間距密度。遵循其既有的動畫語言,除非下列原則規定了特定的互動模式。

排版(文字換行、字型渲染、表格數字、間距)由 better-typography 技能涵蓋;請使用該技能處理任何與文字相關的事項。無障礙性(點擊區域、焦點狀態、鍵盤支援、ARIA、減少動畫)由 better-accessibility 技能涵蓋。佈局結構(分組、區塊間距、斷點、空間 RTL)由 better-layout 技能涵蓋。

快速參考

類別使用時機
表面邊框半徑、光學對齊、陰影、圖片輪廓
動畫可中斷動畫、進出場過渡、圖示動畫、按壓縮放、動作節制
圖示圖示筆畫粗細、透過 currentColor 的狀態、輪廓與填滿、尺寸、RTL 翻轉
效能過渡屬性特異性、will-change 的使用

核心原則

1. 同心圓邊框半徑

外層半徑 = 內層半徑 + 內邊距。巢狀元素半徑不匹配是最常讓介面感覺不對勁的原因。

2. 光學對齊優先於幾何對齊

當幾何置中看起來不對時,改用光學對齊。帶有圖示的按鈕、播放三角形和非對稱圖示都需要手動調整。

3. 陰影製造層次,邊框定義結構

對於按鈕、卡片和容器,若其邊框僅為創造深度而存在,則偏好使用多層透明的 box-shadow 值。保留用於傳達結構或狀態的邊框:分隔線、佈局分隔線,以及選中或聚焦狀態。

4. 可中斷動畫

對互動狀態的變化使用 CSS 過渡效果:它們可以在動畫進行中被中斷。保留 keyframes 用於僅執行一次的階段性序列。

5. 分割並交錯進場動畫

對於不頻繁的階段性進場,若順序有助於傳達層級結構,將內容拆分成語意區塊,並以約 100ms 的間隔交錯出現,而不是動畫化整個容器。請不要在常規、高頻率的互動中使用交錯。

6. 微妙的退場動畫

使用一個小的固定 translateY 而不是完整高度。退場應比進場更柔和。進場和退場過渡都使用 ease-out。

7. 情境式圖示動畫

使用 opacity、scale 和 blur 來動畫化圖示,而不是切換可見性。確切使用這些數值:scale 從 0.25 到 1,opacity 從 0 到 1,blur 從 4px 到 0px。如果專案的 package.json 中有 motion 或 framer-motion,則匹配該套件的導入路徑(或兩者都存在時匹配既有的相鄰導入),並使用 transition: { type: "spring", duration: 0.3, bounce: 0 };bounce 必須始終為 0。如果未安裝 motion 庫,則將兩個圖示都保留在 DOM 中(一個絕對定位),並使用 cubic-bezier(0.2, 0, 0, 1) 的 CSS 過渡進行交叉淡入淡出;這可在無需任何依賴的情況下同時實現進場和退場動畫。

8. 圖片輪廓

為圖片添加一個微妙的 1px 低不透明度的輪廓,以獲得一致的深度感。顏色在淺色模式下必須是純黑色(oklch(0 0 0 / 0.1)),在深色模式下必須是純白色(oklch(1 0 0 / 0.1)),絕不能使用接近黑色的顏色,如石板灰、鋅灰或任何帶色調的中性色。帶色調的輪廓會吸收其下方的表面顏色,在圖片邊緣看起來像污漬。

9. 按壓縮放

點擊時微妙的 scale(0.96) 能為按鈕提供觸覺回饋。務必使用 0.96。絕不使用小於 0.95 的值:任何低於此的值都會感覺誇張。添加一個 static 屬性,以便在動畫會分散注意力時將其停用。

10. 頁面載入時跳過動畫

對 AnimatePresence 使用 initial={false} 以防止首次渲染時的進場動畫。確認這不會破壞有意的進場動畫。

11. 絕不使用 transition: all

始終指定確切的屬性:transition-property: scale, opacity。Tailwind 的 transition-transform 涵蓋了 transform, translate, scale, rotate。

12. 節制使用 will-change

僅用於 transform、opacity、filter 這些 GPU 可以合成的屬性。絕不使用 will-change: all。僅在發現首幀卡頓時才添加。

13. 圖示筆畫粗細匹配文字字重

圖示旁的文字會決定其視覺重量:1.5px 筆畫粗細對應常規(400)文字,2px 對應 semibold(600)。每個圖示集使用同一種筆畫粗細;切勿在同一個表面上混用不同的圖示庫。

14. 一個 SVG,按狀態重新著色

圖示使用 currentColor,並透過 CSS 的 color 和 opacity 獲得其狀態(懸停、選中、禁用),而非使用單獨的資源。輪廓變體是預設值;填滿變體表示啟用狀態。

15. 動作節制

對高頻率的互動不要使用自訂動畫:每次觸發都會重複注意力成本。動畫絕不是唯一的回饋通道;每個動畫化的狀態變化也需要一個靜態提示(顏色、圖示、標籤)。

常見錯誤

錯誤修正方法
緊密巢狀的父層與子層使用相同的邊框半徑計算 outerRadius = innerRadius + padding
圖示看起來未置中使用內邊距進行光學調整,或直接修正 SVG
僅用於模擬高度層級的邊框使用帶透明度設定的分層 box-shadow;保留結構性與狀態性邊框
突兀的階段性進場或情境式退場交錯不頻繁的進場動畫,並保持保留情境的退場動畫微妙
有狀態的圖示或切換開關在頁面載入時動畫化其預設狀態對該 AnimatePresence 添加 initial={false};保留有意的頁面進場動畫
元素上的 transition: all指定確切的屬性
首幀動畫卡頓添加 will-change: transform(節制使用)
細線圖示搭配粗體文字將筆畫粗細匹配文字字重
每個狀態使用獨立的圖示資源一個使用 currentColor 的 SVG,狀態透過 CSS 控制
到處都是填滿圖示預設使用輪廓,僅在啟用狀態使用填滿
每次懸停或按鍵時都進行進場動畫即時回饋或 ≤150ms 的不透明/顏色過渡

審查輸出格式

僅在使用者要求進行獨立的 UI 精緻度審查時使用此格式。當 better-interface 協調審查時,請將領域證據和發現提供給該技能,並讓其輸出格式、嚴重性等級、合併規則、上限和最終判定優先適用。

以兩部分呈現獨立的審查結果。

發現

按原則分組所有確認的發現。使用一個帶有 嚴重性、位置、之前、之後 和 原因 欄位的 Markdown 表格。切勿使用獨立的「之前:」/「之後:」行。

  • 嚴重性:HIGH 表示使互動產生誤導、無反應或反覆造成干擾;MEDIUM 表示造成明顯的工藝或一致性問題;LOW 表示孤立的細節問題。
  • 位置:引用 path/to/file:line。如果成品沒有原始碼檔案,請引用確切的畫面和元件。
  • 之前 / 之後:顯示目前的實作和可行的替代方案。
  • 原因:指出違反的原則並解釋其如何影響介面。

將重複的系統性問題合併為一行,並列出所有受影響的位置。省略沒有發現的原則。

範例

同心圓邊框半徑

嚴重性位置之前之後原因
LOWsrc/Card.tsx:28卡片上使用 rounded-xl + 內部按鈕 (p-2) 使用 rounded-xl卡片上使用 rounded-2xl (8 + 8 = 16),內部按鈕使用 rounded-lg巢狀角落應為同心圓
LOWsrc/card.css:11兩個巢狀表面的 border-radius: 16px外層 24px,內層 16px,內邊距 8px相等的巢狀半徑會使內部表面看起來被擠壓

按壓縮放

嚴重性位置之前之後原因
LOWsrc/Button.tsx:19<button className="...">添加 active:scale-[0.96] transition-transform按壓回饋使控制項感覺有反應
MEDIUMsrc/button.css:24按壓時 scale(0.9)提升為 scale(0.96)任何低於 0.95 的值都感覺誇張

驗證與最終判定

在發現之後:

  1. 驗證:列出執行過的精確檢查及其觀察結果。當涉及動畫時,逐一檢查每個相關狀態並以 10% 的速度檢視動畫。如果某項檢查未執行,說明仍需驗證的項目。
  2. 最終判定:如果仍有任何 HIGH 級別的發現,則為 Block;如果僅有 MEDIUM 或 LOW 級別的發現,則為 Needs changes;僅在沒有可處理的發現時才為 Approve。

當沒有發現時,省略表格,陳述「無可處理的 UI 精緻度發現」,報告驗證結果,並以 Approve 結束。

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.

相關技能