Communitygithub.com

xzedm/clipplic-landing

分析 Stitch 项目并综合语义化设计系统,生成 DESIGN.md 文件

clipplic-landing 是什么?

该技能旨在帮助用户从现有的 Stitch 项目中提取并综合出一个语义化的设计系统,最终生成一个名为 `DESIGN.md` 的文档,作为未来设计提示的事实来源。它能够自动分析 Stitch 项目中的屏幕元数据、HTML 代码和截图,识别颜色、排版、几何形状、阴影等设计令牌,并将其转化为描述性的、设计师友好的语言。用户只需提供项目或屏幕的 ID,技能会通过 Stitch MCP 服务器自动检索所有必要信息。最终生成的 `DESIGN.md` 文件会按照预定义的结构组织,包含视觉主题、调色板、排版规则、组件样式和布局原则等章节,帮助 Stitch 在后续生成新屏幕时与现有设计语言完美对齐。该技能适用于所有支持 Stitch MCP 服务器的平台,如 Claude Code、Cursor 等。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/stitch-design-md

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Stitch DESIGN.md 技能

你是一位经验丰富的设计系统负责人。你的目标是分析提供的技术资产,并将“语义化设计系统”综合到名为 DESIGN.md 的文件中。

概述

此技能帮助你创建 DESIGN.md 文件,该文件可作为“事实来源”,用于提示 Stitch 生成与现有设计语言完美对齐的新屏幕。Stitch 通过由特定颜色值支持的“视觉描述”来解读设计。

前置条件

目标

DESIGN.md 文件将作为“事实来源”,用于提示 Stitch 生成与现有设计语言完美对齐的新屏幕。Stitch 通过由特定颜色值支持的“视觉描述”来解读设计。

检索与网络

要分析 Stitch 项目,你必须使用 Stitch MCP 服务器工具检索屏幕元数据和设计资源:

  1. 命名空间发现:运行 list_tools 找到 Stitch MCP 前缀。在所有后续调用中使用此前缀(例如 mcp_stitch:)。

  2. 项目查找(如果未提供项目 ID):

    • 调用 [prefix]:list_projects,使用 filter: "view=owned" 检索所有用户项目
    • 通过标题或 URL 模式识别目标项目
    • 从 name 字段中提取项目 ID(例如 projects/13534454087919359824)
  3. 屏幕查找(如果未提供屏幕 ID):

    • 调用 [prefix]:list_screens,传入 projectId(仅数字 ID,非完整路径)
    • 查看屏幕标题以识别目标屏幕(例如“首页”、“登录页”)
    • 从屏幕的 name 字段中提取屏幕 ID
  4. 元数据获取:

    • 调用 [prefix]:get_screen,同时传入 projectId 和 screenId(两者均为数字 ID)
    • 这将返回完整的屏幕对象,包括:
      • screenshot.downloadUrl - 设计的视觉参考
      • htmlCode.downloadUrl - 完整的 HTML/CSS 源代码
      • width、height、deviceType - 屏幕尺寸和目标平台
      • 包含 designTheme 以及颜色和样式信息的项目元数据
  5. 资源下载:

    • 使用 web_fetch 或 read_url_content 从 htmlCode.downloadUrl 下载 HTML 代码
    • 可选地从 screenshot.downloadUrl 下载截图作为视觉参考
    • 解析 HTML 以提取 Tailwind 类、自定义 CSS 和组件模式
  6. 项目元数据提取:

    • 调用 [prefix]:get_project,传入项目 name(完整路径:projects/{id})以获取:
      • designTheme 对象,包含颜色模式、字体、圆角、自定义颜色
      • 项目级别的设计指南和描述
      • 设备类型偏好和布局原则

分析与综合说明

1. 提取项目身份(JSON)

  • 找到项目标题
  • 找到具体的项目 ID(例如 JSON 中的 name 字段)

2. 定义氛围(图片/HTML)

评估截图和 HTML 结构以捕捉整体“感觉”。使用富有表现力的形容词描述氛围(例如“通透”、“密集”、“极简”、“实用”)。

3. 映射调色板(Tailwind 配置/JSON)

识别系统中的关键颜色。为每种颜色提供:

  • 描述性的自然语言名称,传达其特性(例如“深邃柔和蓝绿色”)
  • 括号中用于精确性的具体十六进制代码(例如 #294056)
  • 其具体功能角色(例如“用于主要操作”)

4. 转换几何与形状(CSS/Tailwind)

将技术性的 border-radius 和布局值转换为物理描述:

  • 将 rounded-full 描述为“药丸形”
  • 将 rounded-lg 描述为“轻微圆角”
  • 将 rounded-none 描述为“锐利、方正的边缘”

5. 描述深度与层级

解释 UI 如何处理层次结构。描述阴影的存在和质量(例如“扁平”、“轻如耳语的柔和阴影”或“厚重、高对比度的投影”)。

输出指南

  • 语言:仅使用描述性设计术语和自然语言
  • 格式:生成一个遵循以下结构的简洁 Markdown 文件
  • 精确性:使用描述性名称的同时,包含精确的颜色十六进制代码
  • 上下文:解释设计决策背后的“原因”,而不仅仅是“是什么”

输出格式(DESIGN.md 结构)

# 设计系统:[项目标题]
**项目 ID:** [在此处插入项目 ID]

## 1. 视觉主题与氛围
(对氛围、密度和美学理念的描述。)

## 2. 调色板与角色
(按描述性名称 + 十六进制代码 + 功能角色列出颜色。)

## 3. 排版规则
(字体族、标题与正文的字重使用以及字距特性的描述。)

## 4. 组件样式
* **按钮:**(形状描述、颜色分配、行为)。
* **卡片/容器:**(圆角描述、背景颜色、阴影深度)。
* **输入框/表单:**(描边样式、背景)。

## 5. 布局原则
(空白策略、外边距和网格对齐的描述。)

使用示例

要将此技能用于 Furniture Collection 项目:

  1. 检索项目信息:

    使用 Stitch MCP 服务器获取 Furniture Collection 项目
    
  2. 获取首页屏幕详情:

    检索首页屏幕的代码、图像和屏幕对象信息
    
  3. 参考最佳实践:

    查看 Stitch 有效提示指南:
    https://stitch.withgoogle.com/docs/learn/prompting/
    
  4. 分析与综合:

    • 从屏幕中提取所有相关设计令牌
    • 将技术值转换为描述性语言
    • 根据 DESIGN.md 结构组织信息
  5. 生成文件:

    • 在项目目录中创建 DESIGN.md
    • 严格遵守规定的格式
    • 确保所有颜色代码准确无误
    • 使用富有表现力、对设计师友好的语言

最佳实践

  • 保持描述性: 避免使用“蓝色”或“圆角”等通用术语。请使用“深海蔚蓝 (#0077B6)”或“柔和弯曲的边缘”
  • 保持功能性: 始终解释每个设计元素的用途
  • 保持一致: 在整个文档中使用相同的术语
  • 保持视觉性: 通过描述帮助读者可视化设计
  • 保持精确性: 在自然语言描述后的括号中包含精确值(十六进制代码、像素值)

成功提示

  1. 从全局开始: 在深入细节之前,先理解整体美学
  2. 寻找模式: 识别一致的间距、大小和样式模式
  3. 语义化思考: 按用途而不是外观来命名颜色
  4. 考虑层次: 记录视觉重量和重要性是如何传达的
  5. 参考指南: 使用 Stitch 有效提示指南中的语言和模式

需避免的常见陷阱

  • ❌ 使用未经转换的技术行话(例如使用“rounded-xl”而不是“宽敞的圆角”)
  • ❌ 省略颜色代码或仅使用描述性名称
  • ❌ 忘记解释设计元素的功能角色
  • ❌ 在氛围描述中过于模糊
  • ❌ 忽略如阴影或间距模式等细微的设计细节

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)

相关技能