Ant Design System Initializer
Constraint: Only use this skill when the user explicitly mentions "Pencil" and "Ant Design" (or "antd") or when orchestrating a Pencil design system initialization task.
When to use this skill
Use this skill when you need to initialize a new design system based on Ant Design specifications, specifically to set up the global color palette and create the initial component library frames in a .pen file.
How to use this skill
This skill outputs a PENCIL_PLAN. The Agent then calls Pencil MCP tools in order: open_document, set_variables, batch_design, optionally get_screenshot.
Step 1: Initialize Variables (set_variables)
Use mcp__pencil__set_variables to register Ant Design design tokens. Follow .pen file schema.
Primary / Semantic
ant-primary: #1677ff
ant-primary-hover: #4096ff
ant-success: #52c41a
ant-warning: #faad14
ant-error: #ff4d4f
ant-info: #1677ff
Neutral / Text
ant-text: #000000e0
ant-text-secondary: #00000073
ant-border: #d9d9d9
ant-bg: #ffffff
Font & Radius
ant-font-size-base: 14px
ant-border-radius: 6px
Fill from Ant Design token docs if more tokens are needed.
Step 2: Create Component Overview Structure (batch_design)
Use mcp__pencil__batch_design to create a "Components Overview" frame with sections based on Ant Design documentation:
- General (通用)
- Layout (布局)
- Navigation (导航)
- Affix, Breadcrumb, Dropdown, Menu, Pagination, Steps, Tabs
- Data Entry (数据录入)
- AutoComplete, Cascader, Checkbox, DatePicker, Form, Input, InputNumber, Radio, Rate, Select, Slider, Switch, TimePicker, Transfer, Upload
- Data Display (数据展示)
- Avatar, Badge, Calendar, Card, Carousel, Collapse, Descriptions, Empty, Image, List, Popover, Statistic, Table, Tabs, Tag, Timeline, Tooltip, Tree
- Feedback (反馈)
- Alert, Drawer, Message, Modal, Notification, Progress, Result, Skeleton, Spin
Organize frames using Auto Layout. Keep each batch_design call to maximum 25 operations.
Best Practices
- Verify token values against Ant Design token documentation.
- Use
set_variables with replace: false unless a full reset is requested.
- Use Auto Layout for component overview frames.
Keywords
pencil, antd, ant design, design system, init, variables, components
References
references/contract.md – Design tokens and component naming.
references/official.md – Link to official documentation.
references/examples.md – Example PENCIL_PLAN.
references/components.md – Component specifications.
能力边界
✅ 适用场景
- 当你需要使用此技能对应的技术栈时
- 当项目需要遵循最佳实践时
- 当需要快速上手或深入理解核心概念时
⚠️ 需要注意
- 复杂业务逻辑需要结合具体场景调整
- 性能优化需要根据实际数据量评估
❌ 不适用场景
常见陷阱 (Gotchas)
- 版本兼容性:注意框架版本与依赖库的兼容性,不同版本 API 可能有差异
- 配置文件格式:配置文件格式错误是最常见的问题,建议使用编辑器的语法检查
- 环境变量:确保所有必要的环境变量已正确设置,敏感信息不要硬编码
- 依赖冲突:多版本共存时注意依赖冲突,使用 lock 文件锁定版本
- 性能陷阱:大数据量场景下注意性能优化,避免 N+1 查询等常见问题
1---2name: pencil-ui-design-system-antd3description: Initialize Ant Design. design system components in Pencil variables and component overview.4license: Complete terms in LICENSE.txt5---678# Ant Design System Initializer910**Constraint**: Only use this skill when the user explicitly mentions "Pencil" and "Ant Design" (or "antd") or when orchestrating a Pencil design system initialization task.1112## When to use this skill1314Use this skill when you need to initialize a new design system based on Ant Design specifications, specifically to set up the global color palette and create the initial component library frames in a .pen file.1516## How to use this skill1718This skill outputs a PENCIL_PLAN. The Agent then calls Pencil MCP tools in order: `open_document`, `set_variables`, `batch_design`, optionally `get_screenshot`.1920### Step 1: Initialize Variables (set_variables)2122Use `mcp__pencil__set_variables` to register Ant Design design tokens. Follow .pen file schema.2324**Primary / Semantic**25- `ant-primary`: `#1677ff`26- `ant-primary-hover`: `#4096ff`27- `ant-success`: `#52c41a`28- `ant-warning`: `#faad14`29- `ant-error`: `#ff4d4f`30- `ant-info`: `#1677ff`3132**Neutral / Text**33- `ant-text`: `#000000e0`34- `ant-text-secondary`: `#00000073`35- `ant-border`: `#d9d9d9`36- `ant-bg`: `#ffffff`3738**Font & Radius**39- `ant-font-size-base`: `14px`40- `ant-border-radius`: `6px`4142Fill from Ant Design token docs if more tokens are needed.4344### Step 2: Create Component Overview Structure (batch_design)4546Use `mcp__pencil__batch_design` to create a "Components Overview" frame with sections based on Ant Design documentation:47481. **General (通用)**49 - Button, Icon, Typography502. **Layout (布局)**51 - Grid, Divider, Space523. **Navigation (导航)**53 - Affix, Breadcrumb, Dropdown, Menu, Pagination, Steps, Tabs544. **Data Entry (数据录入)**55 - AutoComplete, Cascader, Checkbox, DatePicker, Form, Input, InputNumber, Radio, Rate, Select, Slider, Switch, TimePicker, Transfer, Upload565. **Data Display (数据展示)**57 - Avatar, Badge, Calendar, Card, Carousel, Collapse, Descriptions, Empty, Image, List, Popover, Statistic, Table, Tabs, Tag, Timeline, Tooltip, Tree586. **Feedback (反馈)**59 - Alert, Drawer, Message, Modal, Notification, Progress, Result, Skeleton, Spin6061Organize frames using Auto Layout. Keep each `batch_design` call to maximum 25 operations.6263## Best Practices6465- Verify token values against Ant Design token documentation.66- Use `set_variables` with `replace: false` unless a full reset is requested.67- Use Auto Layout for component overview frames.6869## Keywords7071pencil, antd, ant design, design system, init, variables, components7273## References7475- `references/contract.md` – Design tokens and component naming.76- `references/official.md` – Link to official documentation.77- `references/examples.md` – Example PENCIL_PLAN.78- `references/components.md` – Component specifications.7980## 能力边界8182### ✅ 适用场景83- 当你需要使用此技能对应的技术栈时84- 当项目需要遵循最佳实践时85- 当需要快速上手或深入理解核心概念时8687### ⚠️ 需要注意88- 复杂业务逻辑需要结合具体场景调整89- 性能优化需要根据实际数据量评估9091### ❌ 不适用场景92- 不相关的技术栈或框架93- 需要完全自定义的特殊场景9495## 常见陷阱 (Gotchas)96971. **版本兼容性**:注意框架版本与依赖库的兼容性,不同版本 API 可能有差异982. **配置文件格式**:配置文件格式错误是最常见的问题,建议使用编辑器的语法检查993. **环境变量**:确保所有必要的环境变量已正确设置,敏感信息不要硬编码1004. **依赖冲突**:多版本共存时注意依赖冲突,使用 lock 文件锁定版本1015. **性能陷阱**:大数据量场景下注意性能优化,避免 N+1 查询等常见问题