Setup & Installation
npx skills add https://github.com/WordPress/agent-skills --skill wp-block-themes
https://github.com/WordPress/agent-skills/tree/trunk/skills/wp-block-themes
View on GitHubWhat This Skill Does
Covers WordPress block theme development: editing theme.json for global settings and styles, building templates and template parts, registering patterns, adding style variations, and debugging Site Editor issues like style hierarchy conflicts and user customization overrides.
Block theme file layout and style hierarchy are non-obvious, and mistakes like editing the wrong theme root or forgetting that user customizations override theme defaults are common — this skill surfaces those checks automatically.
When to use it
- Editing theme.json color presets and typography scale for a client site
- Adding a new template part for a custom footer layout
- Registering a filesystem pattern that shows up in the block inserter
- Creating a style variation that lets users switch to a dark color palette
- Debugging why theme.json font size changes aren't showing in the Site Editor