teachingai/pencil-ui-design-system-antd

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:

• The user wants to initialize Ant Design tokens (colors, typography, radius) in a Pencil .pen file
• The user needs a component overview frame for antd components in Pencil
• The user mentions "Pencil" together with "Ant Design", "antd", or antd-specific components (Button, Table, Modal, Form)
• An orchestrator skill (pencil-ui-designer) routes an antd 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 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:

1. General (通用)
   • Button, Icon, Typography
2. Layout (布局)
   • Grid, Divider, Space
3. Navigation (导航)
   • Affix, Breadcrumb, Dropdown, Menu, Pagination, Steps, Tabs
4. Data Entry (数据录入)
   • AutoComplete, Cascader, Checkbox, DatePicker, Form, Input, InputNumber, Radio, Rate, Select, Slider, Switch, TimePicker, Transfer, Upload
5. Data Display (数据展示)
   • Avatar, Badge, Calendar, Card, Carousel, Collapse, Descriptions, Empty, Image, List, Popover, Statistic, Table, Tabs, Tag, Timeline, Tooltip, Tree
6. Feedback (反馈)
   • Alert, Drawer, Message, Modal, Notification, Progress, Result, Skeleton, Spin

Organize frames using Auto Layout. Keep each batch_design call to maximum 25 operations.

Example: Initialize Ant Design Variables

{
  "name": "set_variables",
  "arguments": {
    "filePath": "designs/app.pen",
    "replace": false,
    "variables": {
      "ant-primary": "#1677ff",
      "ant-success": "#52c41a",
      "ant-warning": "#faad14",
      "ant-error": "#ff4d4f",
      "ant-text": "#000000e0",
      "ant-border": "#d9d9d9",
      "ant-font-size-base": "14px",
      "ant-border-radius": "6px"
    }
  }
}

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

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.