If you're building WordPress admin interfaces, Gutenberg blocks, or anything touching WooCommerce or Jetpack, this skill keeps you aligned with the WordPress Design System without constant documentation hunting. It leans heavily on the WPDS MCP server for canonical component specs, design tokens, and spacing scales, which means you're not getting stale web search results. The skill is opinionated about staying in UI land (it explicitly skips data fetching and i18n concerns) and assumes you're working in TypeScript and React unless told otherwise. One thing worth noting: it will push back if you try to bypass the MCP server for WPDS docs, which is the right call but requires that server to actually be running.

skills.sh installs
4.3K
GitHub stars
2.3K
last updated
Aug 21, 2026

Install

$ npx -y skills add wordpress/agent-skills --skill wpds --agent claude-code

Installs into .claude/skills of the current project.

Files

WordPress Design System (WPDS)

Prerequisites

This skill works best with the WPDS MCP server installed. The MCP provides access to WordPress Design System documentation and resources, such as components and DS token lists.

The following terms should be treated as synonyms:

  • "WordPress" and "WP";
  • "Design System" and "DS";
  • "WordPress Design System" and "WPDS".

When to use

Use this skill when the user mentions:

  • building and/or reviewing any UI in a WordPress-related context (for example, Gutenberg, WooCommerce, WordPress.com, Jetpack, etc etc);
  • WordPress Design System, WPDS, Design System;
  • UI components, Design tokens, color primitives, spacing scales, typography variables and presets;
  • Specific component packages such as @wordpress/components or @wordpress/ui;

Rules

Use the WPDS MCP server to access WPDS-related documentation

Sponsors

Details

Repository
github.com/wordpress/agent-skills
Categories
AI & Agent Building, Design & UI/UX, PHP & Laravel
First seen
Apr 16, 2026

More from wordpress/agent-skills

All 17
1amelnagdy avatartest-guardamelnagdy/guard-skillsReview generated or changed test code against universal testing rules before it ships. Best used reactively after an agent writes, edits, generates, or refactor4.3Kskills.sh installs
2dpearson2699 avatarapple-on-device-aidpearson2699/swift-ios-skillsBuild private, on-device AI features on iPhone, iPad, and Mac with Foundation Models, Core ML, MLX Swift, or llama.cpp. Use when choosing an Apple-local model r4.2Kskills.sh installs
3grafana avatarskill-authoringgrafana/skillsAuthor, audit, and improve Grafana SKILL.md files against Anthropic's published Agent Skills guidance and the four-dimension rubric the grafana/skills CI gate u4.2Kskills.sh installs
4freestylefly avatargpt-image-2-style-libraryfreestylefly/awesome-gpt-image-2Choose GPT-Image2 / gpt-image-2 visual styles and industrial prompt templates from the awesome-gpt-image-2 style library. Use when an agent needs to create, rew4.2Kskills.sh installs
5dotnet avatartechnology-selectiondotnet/skillsGuides technology selection and implementation of AI and ML features in .NET 8+ applications using ML.NET, Microsoft.Extensions.AI (MEAI), Microsoft Agent Frame4.1Kskills.sh installs
6softaworks avatardependency-updatersoftaworks/agent-toolkitSmart dependency management for any language. Auto-detects project type, applies safe updates automatically, prompts for major versions, diagnoses and fixes dep4.1Kskills.sh installs