Vant Design System Initializer
Constraint: Only use this skill when the user explicitly mentions "Pencil" and "Vant" (or "Vant 4") 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 Vant 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 Vant design tokens. Follow .pen file schema.
Primary / Semantic
van-primary-color: #1989favan-success-color: #07c160van-warning-color: #ff976avan-danger-color: #ee0a24van-gray-color: #323233
Text & Border
van-text-color: #323233van-text-color-2: #646566van-text-color-3: #969799van-border-color: #ebedf0van-border-radius: 4px
Font
Fill from Vant theme 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 Vant documentation:
- Basic (基础)
- Button, Cell, Icon, Image, Layout, Popup, Space, ConfigProvider
- Form (表单)
- Calendar, Cascader, Checkbox, DatetimePicker, Field, Form, NumberKeyboard, PasswordInput, Picker, Radio, Rate, Search, Slider, Stepper, Switch, Upload
- Feedback (反馈)
- ActionSheet, Dialog, DropdownMenu, Loading, Notify, Overlay, ShareSheet, SwipeCell, Toast
- Display (展示)
- Badge, Circle, Collapse, CountDown, Divider, Empty, ImagePreview, Laziness, List, NoticeBar, Progress, Skeleton, Steps, Sticky, Swipe, Tag
- Navigation (导航)
- ActionBar, Grid, IndexBar, NavBar, Pagination, Sidebar, Tab, Tabbar, TreeSelect
Organize frames using Auto Layout. Keep each batch_design call to maximum 25 operations.
Best Practices
- Verify token values against Vant theme documentation.
- Use
set_variables with replace: false unless a full reset is requested.
- Use Auto Layout for component overview frames.
Keywords
pencil, vant, vant 4, 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-vant3description: Initialize Vant. design system components in Pencil variables and component overview.4license: Complete terms in LICENSE.txt5---678# Vant Design System Initializer910**Constraint**: Only use this skill when the user explicitly mentions "Pencil" and "Vant" (or "Vant 4") 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 Vant 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 Vant design tokens. Follow .pen file schema.2324**Primary / Semantic**25- `van-primary-color`: `#1989fa`26- `van-success-color`: `#07c160`27- `van-warning-color`: `#ff976a`28- `van-danger-color`: `#ee0a24`29- `van-gray-color`: `#323233`3031**Text & Border**32- `van-text-color`: `#323233`33- `van-text-color-2`: `#646566`34- `van-text-color-3`: `#969799`35- `van-border-color`: `#ebedf0`36- `van-border-radius`: `4px`3738**Font**39- `van-font-size-md`: `14px`4041Fill from Vant theme docs if more tokens are needed.4243### Step 2: Create Component Overview Structure (batch_design)4445Use `mcp__pencil__batch_design` to create a "Components Overview" frame with sections based on Vant documentation:46471. **Basic (基础)**48 - Button, Cell, Icon, Image, Layout, Popup, Space, ConfigProvider492. **Form (表单)**50 - Calendar, Cascader, Checkbox, DatetimePicker, Field, Form, NumberKeyboard, PasswordInput, Picker, Radio, Rate, Search, Slider, Stepper, Switch, Upload513. **Feedback (反馈)**52 - ActionSheet, Dialog, DropdownMenu, Loading, Notify, Overlay, ShareSheet, SwipeCell, Toast534. **Display (展示)**54 - Badge, Circle, Collapse, CountDown, Divider, Empty, ImagePreview, Laziness, List, NoticeBar, Progress, Skeleton, Steps, Sticky, Swipe, Tag555. **Navigation (导航)**56 - ActionBar, Grid, IndexBar, NavBar, Pagination, Sidebar, Tab, Tabbar, TreeSelect5758Organize frames using Auto Layout. Keep each `batch_design` call to maximum 25 operations.5960## Best Practices6162- Verify token values against Vant theme documentation.63- Use `set_variables` with `replace: false` unless a full reset is requested.64- Use Auto Layout for component overview frames.6566## Keywords6768pencil, vant, vant 4, design system, init, variables, components6970## References7172- `references/contract.md` – Design tokens and component naming.73- `references/official.md` – Link to official documentation.74- `references/examples.md` – Example PENCIL_PLAN.75- `references/components.md` – Component specifications.7677## 能力边界7879### ✅ 适用场景80- 当你需要使用此技能对应的技术栈时81- 当项目需要遵循最佳实践时82- 当需要快速上手或深入理解核心概念时8384### ⚠️ 需要注意85- 复杂业务逻辑需要结合具体场景调整86- 性能优化需要根据实际数据量评估8788### ❌ 不适用场景89- 不相关的技术栈或框架90- 需要完全自定义的特殊场景9192## 常见陷阱 (Gotchas)93941. **版本兼容性**：注意框架版本与依赖库的兼容性，不同版本 API 可能有差异952. **配置文件格式**：配置文件格式错误是最常见的问题，建议使用编辑器的语法检查963. **环境变量**：确保所有必要的环境变量已正确设置，敏感信息不要硬编码974. **依赖冲突**：多版本共存时注意依赖冲突，使用 lock 文件锁定版本985. **性能陷阱**：大数据量场景下注意性能优化，避免 N+1 查询等常见问题
full-stack-skills