Vant Design System Initializer Skill

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:

The user wants to initialize Vant 4 tokens (primary, success, warning, danger colors) in a Pencil .pen file
The user needs a component overview frame for Vant components in Pencil
The user mentions "Pencil" together with "Vant", "Vant 4", or Vant-specific components (Cell, Form, Dialog, Tabbar)
An orchestrator skill (pencil-ui-designer) routes a Vant initialization request

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: #1989fa
van-success-color: #07c160
van-warning-color: #ff976a
van-danger-color: #ee0a24
van-gray-color: #323233

Text & Border

van-text-color: #323233
van-text-color-2: #646566
van-text-color-3: #969799
van-border-color: #ebedf0
van-border-radius: 4px

Font

van-font-size-md: 14px

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.

Example: Initialize Vant Variables

{
  "name": "set_variables",
  "arguments": {
    "filePath": "designs/app.pen",
    "replace": false,
    "variables": {
      "van-primary-color": "#1989fa",
      "van-success-color": "#07c160",
      "van-warning-color": "#ff976a",
      "van-danger-color": "#ee0a24",
      "van-text-color": "#323233",
      "van-border-color": "#ebedf0",
      "van-font-size-md": "14px"
    }
  }
}

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.
Keep each batch_design call to maximum 25 operations; split by category if needed.

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.

Agent Skills: Vant Design System Initializer

Install this agent skill to your local

Skill Files