wpds · wordpress — Claude Code skill: what it does, how to install
Feeds WordPress Design System docs to your agent through an MCP server, so UI work lands on real components and tokens instead of guesses.
npx skills add WordPress/agent-skills --skill wpds -a claude-codeWhat wpds does
The skill points the agent at WordPress Design System material: reference pages, the component list, a single component entry, the token list (wpds://pages, wpds://components, wpds://design-tokens). Any UI task in a WordPress context then rests on those docs rather than on what the model remembers.
Start the WPDS MCP server first; without it there is nothing to pull from. Web lookups for WPDS docs are blocked, and pushing for one gets a warning before anything else happens. The assumed stack is TypeScript, React and CSS. Targets WordPress 7.0+ on PHP 7.4.0+.
Scope stays narrow: store fetches and string localization fall outside, the skill handles UI only. Replies close with a recap of the decisions, a note on what was left out, and code you can run. Lint scripts in the project get used to check that code when they exist.
What it helps with
- build a settings screen from
@wordpress/components - swap hardcoded spacing for design tokens
- review a WooCommerce UI against WPDS patterns
- find the right typography preset for a block
- justify component choices in a pull request
Example prompts for the agent
- Build the WooCommerce product card with WPDS components and design tokens
- Check this `@wordpress/ui` component and list the tokens I hardcoded
- Which WPDS components fit a filter sidebar?
How to install wpds
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wpds -a claude-code2Manually: put the files in place
~/.claude/skills/wpds/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/wpds/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wpds -a codex2Manually: put the files in place
.agents/skills/wpds/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wpds -a cursor2Manually: put the files in place
.cursor/skills/wpds/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install WordPress/agent-skills wpds2Manually: put the files in place
.github/skills/wpds/SKILL.md1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wpds -a gemini-cli2Platform CLI
gemini skills install https://github.com/WordPress/agent-skills --path skills/wpdsManually: put the files in place
.devin/skills/wpds/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wpds -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set8
The whole set →Other versions of wpds
Similar
Questions about wpds
How do I install wpds in Claude Code?
Run npx skills add WordPress/agent-skills --skill wpds -a claude-code. The skill file lands at ~/.claude/skills/wpds/SKILL.md.
What does wpds do?
It has the agent read WordPress Design System documentation through the MCP server before touching UI, then pick components, tokens and patterns from there. Each reply ends with the reasoning and working snippets.
What does wpds need to run?
A configured, running WPDS MCP server, which supplies the reference pages, components and tokens. The project should target WordPress 7.0+ and PHP 7.4.0+.