wpds
WordPress Design System (WPDS) skill. Build and review UI that uses WPDS components, design tokens, and patterns across Gutenberg, WooCommerce, WordPress.com, and Jetpack. Reads canonical documentation from the WPDS MCP server instead of the web.
How do I install this agent skill?
npx skills add https://github.com/podo/design-agent-skills --skill wpdsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a safe pointer for installing the official WordPress Design System (WPDS) skill and its associated MCP server from verified WordPress sources.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
wpds
<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->Catalogue stub — full skill: WordPress/agent-skills (
skills/wpds)
Decision tree
-
Is the full skill already installed?
- Global:
f=~/.agents/skills/wpds/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer" - Project:
f=.agents/skills/wpds/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer" installed→ the skill is installed aswpds, invoke it and proceedpointer→ go to step 2
- Global:
-
Detect scope, then install:
[ -e ~/.agents/skills/wpds ] && echo "global" || echo "project"Global:
npx skills add WordPress/agent-skills --skill wpds -g -yProject:
npx skills add WordPress/agent-skills --skill wpds -yClaude Code: send a command as a chat message starting with
!to run it without leaving the conversation.
Heads-up
- Requires: WPDS MCP server (@wordpress/design-system-mcp, experimental); the skill is small and defers to it instead of web lookups
- License: GPL-2.0-or-later
Invoke after install
- Skill name:
wpds - Trigger phrases: "WordPress Design System", "WPDS", "WordPress design tokens", "WordPress UI components"
- Needs the WPDS MCP server configured and running; it targets WordPress 7.0+. Ask the user before adding it. For Claude Code the upstream package documents:
claude mcp add wordpress-design-system -- npx -y --ignore-scripts @wordpress/design-system-mcp@latest(the package is WordPress/gutenbergpackages/design-system-mcp, still experimental)
What it does
Guides building and reviewing WordPress-related UI against the official WordPress Design System: components (including @wordpress/components and @wordpress/ui), design tokens, colour primitives, spacing scales, and typography presets. It retrieves canonical component and token documentation from the WPDS MCP server rather than searching the web, assumes TypeScript, React, and CSS unless told otherwise, validates with the project's lint scripts when available, and closes each answer with a recap of decisions and what was left out of scope.
When NOT to use
- Non-UI WordPress work (plugins, REST API, WP-CLI, blocks logic) → install the other skills in
WordPress/agent-skillsdirectly - General design-system governance or token tooling → use
design-system-governanceordesign-tokens-skill - Component library work with shadcn/ui → use
shadcn-ui
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/podo/design-agent-skills/wpds">View wpds on skillZs</a>