Figma Context MCP
Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.
A Claude Code SKILL for designing beautiful, consistent web pages — spec first, code second.
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/skills/xiaopu-ai-web-design)같은 작업에서 AI를 서비스에 연결하는 MCP
Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.
draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand
Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.
같은 종류의 작업, Skill 목록과 같은 순서
| 이 항목 web-design | impeccable | diagram-design | frontend-slides | guizang-ppt-skill | |
|---|---|---|---|---|---|
| 제작자 | xiaopu-ai | pbakaus | cathrynlavery | zarazhangrui | op7418 |
| Skill 수 | 1 | 1 | 1 | 1 | – |
| GitHub 별 | 818 | 111,131 | 67,544 | 32,399 | 29,871 |
| 마지막 코드 변경 | 2026년 6월 24일 | 2026년 11월 16일 | 2026년 11월 13일 | 2026년 6월 24일 | 2026년 10월 30일 |
| 라이선스 | MIT | Apache-2.0 | MIT | MIT | AGPL-3.0 |
xiaopu-ai의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요
MCP = 손
AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.
Skill = 안내서
작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.
겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.
Claude Code
제작자 README와 repo 폴더 기준
GitHub account xiaopu-ai (person), 1 years old
★ 818 stars · code last changed 2026년 6월 24일
4 scripts that can run on a computer: docs/app.js, scripts/crawl_website.py, scripts/extract_design_tokens.py, scripts/fetch_unsplash_images.py
Scripts that go online: scripts/extract_design_tokens.py
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 22a4f48 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
먼저: 어떤 AI를 쓰시나요
쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다
Uploading to claude.ai would fail: the description is over 200 characters (268). Use "Let the AI install it" instead
이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Claude Code를 다시 열고 /web-design를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요
Checked against official docs 2026년 11월 12일 · Source: code.claude.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다
ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
web-design 폴더를 ~/.agents/skills/web-design에 넣으세요
~는 홈 폴더($HOME)입니다
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다
이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
이 문장을 복사해 Cursor 채팅에 붙여 넣으세요
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Cursor Agent 채팅에서 /를 입력하고 web-design 선택
Checked against official docs 2026년 11월 12일 · Source: cursor.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.
2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인
아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요
처음 8,000자 표시 · GitHub에서 전체 파일 열기
---
name: web-design
description: Web 视觉设计 SKILL。输入 PRD / 参考 URL / 截图 / 关键词(任意组合),先产出一份标准化 DESIGN.md 设计规范,用户确认后据此生成 UI/UX、视觉、动效、响应式全部达标的 web 代码。专攻 web 端:Landing Page、Portfolio、产品页、博客、个人站、SaaS 介绍页等。当用户说"帮我做个网站""设计一个页面""参考 XX 做一个""把这个截图/PRD 做成网页""做一个 landing page""出一份 design 规范"时触发。不用于后端、数据库、纯逻辑 bug 修复。
---
# Web Design
Web 端视觉设计 SKILL。两阶段工作流:**先出规范(DESIGN.md),再出代码。**
DESIGN.md 是显式文件产物,保存到项目目录,可跨项目复用、可手动修改、可给其他工具消费。
## 核心流程
```
Phase A 理解需求(灵活输入)──→ Phase B 输出 DESIGN.md(用户确认)──→ Phase C 生成项目代码
```
**启动时先检测**(按优先级):
1. 项目里已经有 DESIGN.md 了吗?→ 有则沿用/修改/重建
2. 项目里有 PRD.md 吗?→ 有则进入 A4(PRD 驱动流程)
3. 都没有 → 正常走 Phase A
---
## Phase A: 理解需求
输入是灵活的,以下任意组合都行,不要强制用户走固定路径:
| 输入 | 处理方式 |
|------|---------|
| **参考 URL** | 抓取 HTML+CSS,提取 Token,motion audit |
| **截图 / 设计稿** | 从视觉提取气质、色温、密度、字体风格 |
| **关键词 / 描述** | "暗色克制衬线风格" → 从 style-seeds 匹配 Token |
| **品牌名** | "做成类似 Linear 的" → 先查 `references/design-systems/`,有则直接读取;无则抓取该网站 |
| **混合** | "参考这个 URL 但配色要暖一些" → 提取 + 覆盖 |
| **PRD 文档** | 读取 PRD.md 的产品定位、页面结构、设计交接区 → 分析竞品风格 → 推导设计方向 |
### A1. URL 分析(有参考 URL 时)
**意图判断**:参考(提取设计语言,做独立新页面)vs 复刻(用户明确说"复刻/clone")。
**抓取流程**(按优先级尝试):
1. **首选:Playwright 爬虫**(真实浏览器,能绕反爬、渲染 SPA、模拟滚动)
```bash
python3 scripts/crawl_website.py --url [URL] --output ./crawl-output --scroll-delay 600
```
输出:每屏视口截图 + tokens.json + structure.json + styles.css
2. **备选:Token 提取脚本**(轻量,适合简单静态站)
```bash
python3 scripts/extract_design_tokens.py --url [URL] --format json
```
3. **降级:手动 curl**(脚本都不可用时)
```bash
curl -Ls [URL]
```
综合三类输入判断:实际体验(氛围节奏)> 截图(局部气质)> Token 数值(精确参数)。Playwright 爬虫的视口截图可直接作为"体验"和"截图"两类输入。
**Motion Audit**(参考站有滚动联动动效时必做):
- 触发信号:动效跟随滚动连续变化 / 模块间有 stagger-pin-parallax / 引用 GSAP-Lenis 等
- 记录每个动效区块的 trigger、driver、elements、effect、timing
**降级链路**:
- Playwright 爬虫失败 → 查 `references/design-systems/` 有无该品牌预置文件(58 个品牌)
- 预置文件也无 → `extract_design_tokens.py` 尝试静态提取
- 静态提取也失败 → 手动 curl CSS
- 全部失败 → 要求用户提供截图,从视觉手动建 Token
### A2. 对话引导(无参考物时)
快速锁定风格方向,不要机械走问答清单:
**核心问题**(按需选问,不全问):
- 亮色 vs 暗色?
- 衬线 vs 无衬线?
- 克制留白 vs 丰富饱满?
- 强调色偏好?
- 有没有喜欢的网站或风格参考?
从 `references/style-seeds.md` 匹配最近似的种子(10 种预设方向),展示给用户确认或混搭。
用户提到具体品牌时,查阅 `references/design-systems/INDEX.md` 按类别检索,按需读取对应品牌文件(58 个真实网站设计规范,每个 ~300 行)。品牌文件只含静态设计系统,动效仍需按交互档位补充。
### A3. 交互档位确认(不可跳过)
| 档位 | 体验感 |
|------|--------|
| **L1** 精致静态 | 优雅 hover + 柔和入场 |
| **L2** 流畅交互 | 滚动 reveal、视差、导航变化 |
| **L3** 沉浸体验 | 滚动驱动时间线、pin、光标跟随、转场 |
L2 追问:reveal 风格(fadeInUp/scaleIn)、视差、导航变化
L3 追问:section pin、光标效果、转场、是否允许 GSAP/ScrollTrigger/Lenis
查阅 `references/interaction-patterns.md` 获取对应档位的完整代码。
### A4. PRD 驱动(检测到项目级规范文件时)
**启动时自动扫描项目根目录**,按优先级:
1. `PRD.md` / `prd.md`
2. `SPEC.md` / `spec.md`
3. `README.md` 或任何 `.md` — 若含「产品定位 / Target Users / Pages / 核心页面」等关键字段
**不绑定特定工具或模板**。只要能从文档里抽到下列字段,就足以作为设计输入:
| 字段(中/英别名) | 用途 |
|-------------------|------|
| 产品名称 / Product / Name | Hero 文案 |
| 一句话定位 / Tagline / Pitch | Hero 副标题、定调 |
| 目标用户 / Target Users / Audience | 色彩温度、字体风格决策 |
| 核心页面 / Pages / Screens | Phase C 生成清单 |
| 竞品 / Competitors / References | Phase A 风格参考起点 |
| 技术栈 / Tech Stack | Phase C 代码生成方案 |
| 设计交接 / Design Notes / 调性 | 直接继承的硬约束 |
**竞品风格分析**:
- PRD 提到竞品 → 优先查 `references/design-systems/` 是否已有预置
- 有预置 → 读取该品牌规范作为起点
- 无预置 → 调用 `scripts/crawl_website.py` 抓取提取
- PRD 没提 → 按产品类型 + 调性从 `references/style-seeds.md` 匹配最近种子
**提取不到关键字段时**:不要瞎猜,回到对话引导(A2)补齐。
**与用户确认**(示例):
> 我从 `{文件名}` 读到了:
> - 产品:{名称} — {一句话定位}
> - 目标用户:{画像}
> - 参考竞品:{列表 或 "无"}
> - 建议的风格方向:{1-2 个候选,各附一句理由}
>
> 这个方向对吗?
确认后进入 A3(交互档位),然后 Phase B。
---
## Phase B: 输出 DESIGN.md(必走)
**必须生成 DESIGN.md 文件。** 按 `references/design-md-template.md` 模板输出 9 个章节:
1. **Visual Theme & Atmosphere** — 设计哲学、氛围关键词、一句话定调
2. **Color Palette & Roles** — 完整 CSS 变量定义(含 RGB 辅助值)
3. **Typography Rules** — 字体族、Google Fonts URL、字号层级表、禁止字体
4. **Component Stylings** — 按钮/卡片/导航/链接/标签等完整 CSS(含所有状态)
5. **Layout Principles** — 网格、间距梯度、容器宽度
6. **Depth & Elevation** — 阴影体系
7. **Animation & Interaction** — 动效档位、入场/滚动/悬停/特效的完整代码
8. **Do's and Don'ts** — 设计护栏、Anti-Patterns(至少 8 条)
9. **Responsive Behavior** — 断点、触摸目标、折叠策略
**文字装饰规则**:生成 Color Palette 和 Typography 后,按 `references/text-decoration-rules.md` 决策表对标题逐级判断是否添加渐变/投影。
**展示摘要给用户确认**,确认后保存 DESIGN.md 到项目目录,再进入 Phase C。
---
## Phase C: 生成项目代码(必走)
### C1. 确认场景 + 收集内容
问用户做什么页面,收集具体内容。查阅 `references/scene-defaults.md` 获取该场景的布局和组件基线。
**常见场景的内容需求**:
| 场景 | 需要收集 |
|------|---------|
| Landing Page | 标题、副标题、Feature 列表、CTA、Social proof |
| 个人站 / Portfolio | 名字、头衔、项目列表、关于、联系方式、博客列表 |
| Blog | 名称、文章列表/内容、作者信息、分类标签 |
| 产品页 | 产品名、卖点、功能截图、定价、FAQ |
用户信息不全时主动问;用户说"你先做,内容我后面填"则用合理的占位内容。
### C2. 设计框架 + 生成代码
1. **检查项目环境**:框架、路由、样式方案、现有组件和 assets
2. **框架决策**:有项目 → 沿用;无项目 → 最小可行方案
3. **严格按 DESIGN.md 生成**:
- 所有颜色通过 CSS 变量引用
- 字体按 DESIGN.md 定义使用
- 交互按 DESIGN.md 指定档位实现
- 不违反 Do's and Don'ts
4. **图片策略**:用户素材 > 项目 assets > 参考站 URL 占位 > Unsplash
5. **图标策略**:项目现有库 > lucide-react > 内联 SVG(参考 `references/icon-library.md`)
### C3. 审计
- **DESIGN.md 合规检查**:代码是否严格遵循规范
- **参考物差异审计**(有参考时):Token / 版式 / 字体 / 交互 / 素材逐项比对
- **响应式验证**:至少移动端 + 桌面端
- **质量清单**:读 `references/quality-checklist.md` 逐项自检
---
## 首页爆点原则(Landing Page 专属)
一个 Web 平台最重要的是**落地页(首页)**。其他页面保持规范、风格统一即可,唯有首页必须满足下面两条硬性原则,不可妥协。
### 原则一:3 个「卧槽」爆点 + 1 个巧思
爆点位置**固定**,每个位置必须有一个让用户"卧槽"的视觉冲击:
| # | 位置 | 要求 | 典型招式 |
|---|------|------|---------|
| **1** | **首屏 / Hero** | 加载瞬间就被动态/3D/巨型渐变震住 | 卡片星座爆发、WebGL 3D 物体、巨型标题 mask reveal、鼠标跟随光斑、3D 卡片堆 |
| **2** | **首次滑动** | 离开首屏的第一个 section 必须有"钩子"继续吸引 | 宣言横滚带(大字 marquee)、数字爆发、分屏切割、卡片汇聚转场、全屏视频 |
| **3** | **列表 / 阵列 / 枚举 / 展示区** | 不能是普通等大 grid | Bento 不等大布局、SpotlightCard hover 跟踪光、3D 倾斜卡片、抽象艺术顶 |
**1 个巧思设计点**:一处"不注意就错过、一注意到就笑"的细节。候选:
- 交互反馈微动画(复制后的 sparkle + tooltip)
- 彩蛋(Konami / Ctrl+K 命令面板)
- Meta 梗(关键词 hover 弹 "这就是本页用到的规范 →")
- 滚动到底的小惊喜(如"你看到这里了,谢谢")
### 原则二:流畅 · 滑动无阻(不可破)
以下是性能红线,与爆点设计**同等优先级**。爆点炸裂但卡顿 = 零分。
- **3D / WebGL**:全页最多 1 处,且必须 IntersectionObserver 不可见时暂停
- **`filter: blur()` on moving elements**:禁止。用 opacity + scale 做景深代替
- **`backdrop-filter: blur()`**:值 ≤ 14px,且不覆盖大面积滚动区
- **Lenis / scroll-jacking**:仅当 pin-scrub 真正必要时启用;普通页面用原生 `scroll-behavior: smooth`
- **ScrollTrigger pin**:单页 ≤ 2 处(doubao 级叙事才解锁)
- **pointermove 监听**:必须 rAF 节流
- **Custom cursor 全局替换**:仅在气质强烈的设计类/工具类站点用,普通 SaaS 禁用
### 实现建议(性能友好的爆点配方)
这些组合实测在中等配置设备可达 60fps:
| 爆点 | 实现 | 性能成本 |
|------|------|---------|
| **鼠标聚光灯** | CSS var `--mx/--my` + `radial-gradient(at var(--mx) var(--my))` | ⭐ 极低(单次 repaint)|
| **卡片爆发入场** | GSAP 一次性 timeline(load 时 stagger 1.5s,结束即释放)| ⭐⭐ 低(仅 1 次)|
| **宣言横滚带** | 纯 CSS `transform: translateX` keyframes | ⭐ 极低 |
| **SpotlightCard** | 每张卡 `--mx/--my` + `::before` radial-gradient(rAF 节流)| ⭐⭐ 低 |
| **大字 mask reveal** | 纯 CSS `clip-path` 一次性动画 | ⭐ 极低 |
| **关键字渐变流动** | `background-position` 动画 | ⭐ 极低 |
避免的反面组合:
- ❌ 12+ 元素同时带 `filter: blur()` + `will-change`(GPU 内存爆)
- ❌ Lenis + 多个 pin-scrub + WebGL(主线程堵死)
- ❌ Three.js 常驻渲染不暂停(即使离开视窗也吃 FPS)
---
## 100 分质量底线(硬性验收)
DESIGN.md + 生成代码必须**同时**满足以下全部条件,任何一条不满足都算未完成。完整细项见 `references/quality-checklist.md`,这里是最核心的红线:
### DESIGN.md 红线
- 9 个章节都有实质内容,不是模板占位
- 每个组件样式包含 default / hover / active / focus / disabled **全部状态**
- 所有颜色定义为 CSS 变量,含 RGB 辅助值(便于 rgba)
- 字体有 `@import` URL + fallback stack
- 动效档位明确(L1/L2/L3),对应依赖声明完整
- Do's and Don'ts ≥ 8 条,其中 Don'ts ≥ 5 条
- L2+ 必须包含 `prefers-reduced-motion` 降级
- 响应式至少覆盖 Desktop + Mobile
### 代码红线
- 所有颜色通过 CSS 变量引用,**零硬编码 hex**
- 字体严格按 DESIGN.md 的 Typography Rules 实现
- 每个可交互元素有 hover + focus 态
- 入场动画已实现(至少 L1 级 fadeIn)
- L2+ 实现滚动 reveal + 导航滚动态 + 视差
- L3 实现 pin / 光标跟随 / 转场
- 图片**禁用纯色块占位**(参考站 URL / Unsplash / 用户素材)
- 图标用项目库 / lucide-react / 内联 SVG(Playful 调性外禁 Emoji)
- 未违反 DESIGN.md Do's and Don'ts 中的任何一条
- 移动端 ≤ 600px 无横向溢出,触摸目标 ≥ 44×44px
### 签名动效红线(L2+ 强制,L3 加倍)
**任何 L2 及以上页面必须包含以下 6 类动效,缺一不可**。优先从 [vue-bits / reactbits](https://github.com/DavidHDev/vue-bits) 目录挑(查 `references/motion-library.md`),能复用源码就不要自己写。
| 类别 | 数量 | 落点 |
|------|------|------|
| Text Animation — Hero H1 | ≥ 1 | 大标题入场或持续态(如 SplitText / ShinyText / GradientText) |
| Text Animati질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.