What it does
Use when building UIs leveraging the WordPress Design System (WPDS) and its components, tokens, patterns, etc.
Install
This skill ships in WordPress/agent-skills (Official, WordPress core fundamentals).
One command installs it for any assistant. Run this from your project root:
npx skills add WordPress/agent-skills --skill wpdsYou'll be asked to choose a scope: project (shared with your team, committed to version control) or global (available across all your projects). Add --global to skip the prompt and install globally.
Use it in your AI assistant
The destination folder, and how the assistant discovers it, differs per tool:
Claude Code
.claude/skills/wpds/ (or ~/.claude/skills/wpds/ for all projects)
- Claude Code auto-discovers skills in .claude/skills/ (project) or ~/.claude/skills/ (global, every project).
- Claude reaches for the skill on its own when a task matches its description, or you can name it directly.
GitHub Copilot (VS Code)
.github/skills/wpds/
- The skill is copied into .github/skills/wpds/, where Copilot in VS Code picks it up.
- Copilot Chat applies it automatically once your task matches the skill's description.
OpenAI Codex
.codex/skills/wpds/
- This installs the skill to .codex/skills/wpds/, which Codex reads for standing instructions on matching tasks.
- Point Codex at it directly if needed: "follow .codex/skills/wpds/SKILL.md for this task."
Cursor
.cursor/skills/wpds/ (or ~/.cursor/skills/wpds/ globally)
- Cursor discovers skills in .cursor/skills/ (project) or ~/.cursor/skills/ (global).
- Cursor loads it automatically when a request matches, same as its native Rules.
Compatibility
Requires WPDS MCP server configured and running. Targets WordPress 7.0+ (PHP 7.4.0+).