Communitygithub.com

xzedm/clipplic-landing

用于设计、重构、塑造、批评、审计、打磨、澄清、提炼、强化、优化、适配、动画化、着色、提取或改进前端界面。涵盖网站、落地页、仪表盘、产品UI、应用壳、组件、表单、设置、引导流程和空状态。处理UX审查、视觉层级、信息架构、认知负荷、可访问性、性能、响应式行为、主题、反模式、排版、字体、间距、布局、对齐、颜色、动效、微交互、UX文案、错误状态、边界情况、国际化以及可复用的设计系统或令牌。也适用于平淡的设计需要变得更大胆或更令人愉悦,喧闹的设计需要变得更安静,在浏览器中实时迭代UI元素,或雄心勃勃的视觉特效需要达到技术上的卓越。不适用于后端任务或非UI任务。

clipplic-landing 是什么?

该技能专注于生成可直接上线的、生产级前端界面代码,而非原型或起点。它提供了一套严格的设计指南,涵盖色彩(对比度验证、OKLCH色彩空间、避免AI默认的米黄色背景)、排版(行宽限制、字体搭配、标题大小和字间距)、布局(正确使用Flexbox与Grid、避免过度使用卡片、建立语义化的z-index层级)、动效(有意图的动画、使用缓出曲线、提供减少动效的替代方案)、交互(处理下拉菜单裁剪问题)以及一系列明确的禁止模式(如侧条纹边框、渐变文字、毛玻璃效果、雷同的卡片网格、每节都有的小写标题等)。对于新项目,它强调基于物理场景选择深色或浅色主题,并指导用户建立色彩策略。它支持多种AI平台(如Claude Code、Cursor、Codex等)并包含特定平台的缺陷修复(如Codex的幽灵卡片、过度圆角等;Gemini的禁止图片悬停动画)。工作流程包括运行上下文脚本、加载子命令参考、熟悉现有设计系统、读取品牌或产品参考,以及为新项目生成品牌调色板。

兼容平台~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。如果请求中指定或暗示了单体仓库中的文件、路由或应用,请推断出具体路径,并改为运行 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 / 令牌 / 主题 / 一个代表性组件或页面)。即使在步骤2中加载了子命令参考,这也是必需的。 不要重新发明轮子;在现有方案有效时使用它们,当用户体验更优时则另辟蹊径。
  4. 读取匹配的注册参考。这是非可选的;跳过它会产生泛化输出。 如果项目是营销类、落地页、广告活动、长文内容或作品集(设计即产品),请读取 reference/brand.md。如果是应用UI、管理后台、仪表盘或工具(设计服务于产品),请读取 reference/product.md。按以下优先级选择:(1) 任务线索("落地页" vs "仪表盘");(2) 正在聚焦的界面(页面、文件或路由);(3) PRODUCT.md 中的 register 字段。
  5. 如果项目是全新的(在步骤3中未找到现有的 CSS 令牌/主题/已提交的品牌颜色),请运行 node {{scripts_path}}/palette.mjs 以获取品牌种子颜色和组合指导。这将作为你主品牌色的锚点。根据脚本的指示,围绕它组合调色板的其余部分(背景、表面、文字、强调色、柔和色)。全程使用 OKLCH。仅当步骤3在现有令牌中找到了已提交的品牌颜色时,才跳过此步骤;在这种情况下,保持品牌一致性优先。

设计指导

产出可直接发布、生产级的代码,而非原型或起点。除非用户要求(如有疑问,请询问),否则不要走捷径。不要停止,直到完成一个完整的实现(美观、响应式、快速、精确、无 Bug、符合品牌)。你非常注重细节:所打造的每个页面、区域或组件,都会使用可用的工具(浏览器截图、计算机使用等功能)进行实战测试。{{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 以减少孤行。

布局

  • 变化间距以创造节奏感。
  • 卡片是懒惰的解决方案。只有当它们真正是最佳交互方式时才使用它们。嵌套卡片永远是错误的。
  • 一维用 Flexbox,二维用 Grid。当 flex-wrap 更简单时,不要默认使用 Grid。
  • 对于无需断点的响应式网格:repeat(auto-fit, minmax(280px, 1fr))。
  • 构建一个语义化的 z-index 层级(下拉菜单 → 粘性元素 → 模态背景 → 模态框 → 通知 → 工具提示)。切勿使用像 999 或 9999 这样的随意数值。

动效

  • 动效应是有意图的,而不应是事后才想到的。将其视为构建过程的一部分。
  • 除非真正必要,否则不要对 CSS 布局属性进行动画。
  • 使用指数曲线(ease-out-quart / quint / expo)进行缓出。不使用弹跳或弹性效果。
  • 对于更高级的动效需求,使用库(例如 motion、gsap、anime.js、lenis 等)。
  • 减少动效不是可选项。每个动画都需要一个 @media (prefers-reduced-motion: reduce) 的替代方案:通常是淡入淡出或瞬时过渡。
  • 对单个列表中的项目应用交错效果是合理的。AI 的痕迹在于统一的反射(每个部分都应用了相同的入场效果),而不是动效本身;每个揭示效果应与其所揭示的内容相匹配。抑制这种反射绝不应该成为发布一个完全没有动效的页面的理由。
  • 揭示动画必须增强一个已经可见的默认状态。不要将内容可见性依赖于由类触发的过渡;过渡会在隐藏的标签页和无头渲染器上暂停,导致揭示效果从未触发,从而使该区域以空白形式呈现。
  • 高级动效素材不仅仅是 transform/opacity。当它们能实质性改善效果并保持流畅时,模糊、背景滤镜、clip-path、遮罩和阴影/发光效果也应成为调色板的一部分。

交互

  • 在 overflow: hidden 或 overflow: auto 容器内使用 position: absolute 渲染的下拉菜单会被裁剪。请使用原生 <dialog> / popover API、position: fixed 或 portal 来逃逸堆叠上下文。

仅限新项目(当没有先前工作时)

颜色与主题

  • 使用 OKLCH。
  • 奶油色/沙色/米色背景是 2026 年 AI 饱和的默认设置。 整个暖中性色带(OKLCH L 0.84-0.97,C < 0.06,色相 40-100)无论你怎么称呼它,读起来都是奶油色/沙色/纸张/羊皮纸。像 --paper、--cream、--sand、--bone、--flour、--linen、--parchment、--wheat、--biscuit、--ivory 这样的令牌名称本身就是一个标志。如果需求是"温暖、传统、家庭海岸意大利风格"或"杂志温暖感"或"编辑性克制",不要将其翻译成一个接近白色的暖色调背景;那是 AI 的做法。选择:(a) 使用饱和的品牌色作为背景(如赤陶色、牛血红、深赭色、近黑色),(b) 使用色度为零(或朝向品牌自身色相,而非默认的温暖方向)的真实米白色,或 (c) 使用明显属于品牌自身的深色中间色调中性色。品牌中的"温暖感"应由强调色、排版和图像来承载,而非由背景色承载。
  • 带色调的中性色:向品牌色相方向增加 0.005–0.015 的色度。不要因为"品牌感觉是那样"就默认向暖或冷色调偏移;那是跨项目的单一文化做法。
  • 选择主题时:深色与浅色永远不是默认选项。不是因为"工具用深色看起来酷"。也不是"为了安全选浅色"。在选择之前,写一句描述物理场景的话:谁在使用它,在哪里,在什么环境光下,带着什么情绪。如果这句话不能强制得出答案,说明它不够具体。添加细节直到它可以。
  • 在选择颜色之前,先选择一种色彩策略。承诺程度上的四个步骤:
    • 克制型:带色调的中性色 + ≤10% 的单一强调色。产品默认选择;品牌极简主义。
    • 承诺型:一种饱和颜色承载 30–60% 的页面面积。品牌默认选择,用于身份驱动的页面。
    • 全调色板型:3–4 个命名角色,每个都被刻意使用。品牌营销活动;产品数据可视化。
    • 浸入型:页面背景本身就是颜色。品牌主视觉或营销活动页面。

绝对禁止项

匹配并拒绝。如果你即将写出以下任何模式,请用不同的结构重写该元素。

  • 侧条纹边框。 在卡片、列表项、标注或警告上使用大于 1px 的 border-left 或 border-right 作为彩色强调。绝非有意为之。请用完整边框、背景色调、前导数字/图标或完全不加来重写。
  • 渐变文字。 将 background-clip: text 与渐变背景结合使用。纯粹装饰,从无意义。请使用单一纯色。通过字重或字号来强调。
  • 默认用毛玻璃效果。 装饰性地使用模糊和玻璃卡片。要么罕见且有目的地使用,要么完全不用。
  • 英雄指标模板。 大数字、小标签、支持性统计数据和渐变强调。SaaS 的陈词滥调。
  • 雷同的卡片网格。 相同大小的卡片,含有图标+标题+文本,无限重复。
  • 每个区域上方都有的小写追踪眉板。 2023 年时代的开场词(带有宽字间距的小型全大写文字,在每个标题上方写着 "关于" "流程" "定价")现在已成为 AI 饱和的脚手架;无论需求如何,它在 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 的装饰。不要这样做。
  • 缺少可见的焦点环。 你为按钮和输入框写出的 :focus-visible 样式,有 75% 的可能性要么缺失,要么只有 outline: none;。每个可交互元素都需要一个可见的焦点环(2-3px 实心线,与该元素在同一方向对齐)。 <! — rule:skill-ban-codex-focus-ring -->
  • SVG 作为字体图标。 像 icon-* 这样的类,将 SVG 内联为背景图像或包含在 <use href="..."> 中。对于生产来说,这没问题。但你在一个页面中生成超过 90 个这样的实例,然后在不相关的对话框中重复它们,这意味着每个图标都重复渲染了相同的 SVG 代码。不要这样做。对于生产图标,请使用一个图标库,或者保持极少的数量。 <! — rule:skill-ban-codex-svg-as-font-icon -->
  • overflow: hidden 在 body 或根元素上。 当你试图实现全屏覆盖或转换时,你使用 overflow: hidden 作为一种 hack。它打破了本地滚动。 <! — rule:skill-ban-codex-body-overflow-hidden -->

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)

相关技能