Ant Design CLI

What it does

When your agent uses it

• Writing antd components and checking the real prop list first
• Debugging an antd prop that behaves differently on one version
• Planning an upgrade from antd v4 to v5
• Scanning a project to see which antd components it uses
• Looking up what changed in a given antd release

Example prompts

• “Build a settings form with antd and check the Select props before you write it.”
• “Migrate this project from antd v4 to v5 and list the breaking changes first.”
• “Scan ./src and tell me which antd components we use most.”
• “Lint this file for deprecated antd usage against the version in package.json.”

Requirements

• Node.js and npm, to install @ant-design/cli globally
• Pre-approved tools (allowed-tools): Bash(antd *), Bash(antd bug*), Bash(antd bug-cli*), Bash(npm install -g @ant-design/cli*), Bash(which antd)

Workflow steps

10 steps, taken from the step headings in SKILL.md.

1. 1Writing antd component code
2. 2Looking up full documentation
3. 3Debugging antd issues
4. 4Migrating between versions
5. 5Analyzing project antd usage
6. 6Checking changelogs and version history
7. 7Exploring available components
8. 8Reporting antd bugs
9. 9Auto-reporting CLI issues
10. 10Using as MCP server

What it can do on your machine

Read from SKILL.md and the folder at commit e65d2d3. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(antd *)
  • Bash(antd bug*)
  • Bash(antd bug-cli*)
  • Bash(npm install -g @ant-design/cli*)
  • Bash(which antd)

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • npm

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • codesandbox.io

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ant Design CLI loads about 2.2k tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 733 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~74

When it runs · the whole SKILL.md, loaded when a task matches

~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ant-design/antd-skill at commit e65d2d3, republished under its MIT licence (© ant-design). 733 words, ~2,161 tokens.

name

antd

description

Use when the user's task involves Ant Design (antd) — writing antd components, debugging antd issues, querying antd APIs/props/tokens/demos, migrating between antd versions, or analyzing antd usage in a project. Triggers on antd-related code, imports from 'antd', or explicit antd questions.

allowed-tools

Bash(antd *), Bash(antd bug*), Bash(antd bug-cli*), Bash(npm install -g @ant-design/cli*), Bash(which antd)

which antd || npm install -g @ant-design/cli

# Check what props are available
antd info Button --format json

# Get a working demo as starting point
antd demo Button basic --format json

# Check semantic classNames/styles for custom styling
antd semantic Button --format json

# Check component-level design tokens for theming
antd token Button --format json

antd doc Table --format json        # full markdown docs for Table
antd doc Table --lang zh            # Chinese docs

# Check if the prop exists for the user's antd version
antd info Select --version 5.12.0 --format json

# Check if the prop is deprecated
antd lint ./src/components/MyForm.tsx --format json

# Diagnose project-level configuration issues
antd doctor --format json

# Get full migration checklist
antd migrate 4 5 --format json

# Check migration for a specific component
antd migrate 4 5 --component Select --format json

# See what changed between two versions
antd changelog 4.24.0 5.0.0 --format json

# See changes for a specific component
antd changelog 4.24.0 5.0.0 Select --format json

# Scan component usage statistics
antd usage ./src --format json

# Filter to a specific component
antd usage ./src --filter Form --format json

# Lint for best practice violations
antd lint ./src --format json

# Check only specific rule categories
antd lint ./src --only deprecated --format json
antd lint ./src --only a11y --format json
antd lint ./src --only performance --format json

# Specific version changelog
antd changelog 5.22.0 --format json

# Version range (both ends inclusive)
antd changelog 5.21.0..5.24.0 --format json

# List all components with categories
antd list --format json

# List components for a specific antd version
antd list --version 5.0.0 --format json

# Step 1: Preview for user review
antd bug --title "DatePicker crashes when selecting date" \
  --reproduction "https://codesandbox.io/s/xxx" \
  --steps "1. Open DatePicker 2. Click a date" \
  --expected "Date is selected" \
  --actual "Component crashes with error" \
  --format json

# Step 2: Show to user, ask for confirmation

# Step 3: Submit after user confirms
antd bug --title "DatePicker crashes when selecting date" \
  --reproduction "https://codesandbox.io/s/xxx" \
  --steps "1. Open DatePicker 2. Click a date" \
  --expected "Date is selected" \
  --actual "Component crashes with error" \
  --submit

antd bug-cli --title "antd info Button returns wrong props for v5.12.0" \
  --description "When querying Button props for version 5.12.0, the output includes props that don't exist in that version" \
  --steps "1. Run: antd info Button --version 5.12.0 --format json" \
  --expected "Props matching antd 5.12.0 Button API" \
  --actual "Props include 'classNames' which was added in 5.16.0" \
  --format json

antd bug-cli --title "antd info Button returns wrong props for v5.12.0" \
  --description "..." \
  --steps "..." \
  --expected "..." \
  --actual "..." \
  --submit

{
  "mcpServers": {
    "antd": {
      "command": "antd",
      "args": ["mcp", "--version", "5.20.0"]
    }
  }
}

© ant-design, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/antd of ant-design/antd-skill.

• SKILL.md
• LICENSE

Open the folder on GitHubat commit e65d2d3