wp-block-themes — Claude Code skill: what it does, how to install
Guides the agent through building WordPress block themes, editing theme.json, and organizing templates. Useful when styles fail to apply in the Site Editor.
npx skills add WordPress/agent-skills --skill wp-block-themes -a claude-codeWhat wp-block-themes does
This skill guides agents working on WordPress block themes. It detects active theme directories using detect_block_themes.mjs and helps structure theme.json without conflating UI controls with block-level styles. The workflow covers templates under templates/, template parts under parts/, and filesystem patterns.
Template parts must not sit inside nested subdirectories, or WordPress will fail to load them. User customizations saved in the database override theme files, which often makes file edits look completely ignored. Running the triage scripts requires Node.js and bash; the skill targets WordPress 7.0+ on PHP 7.4.0+, while specific operations require WP-CLI.
What it helps with
- configure global settings and block styles in theme.json
- troubleshoot style overrides between theme files and the database
- organize HTML templates and template parts in correct folders
- register theme patterns inside the patterns directory
Example prompts for the agent
- Inspect theme.json and add spacing presets for our theme layout
- Find out why the Site Editor ignores my latest block style changes
- Create a new template part for the footer under parts/footer.html
How to install wp-block-themes
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-block-themes -a claude-code2Manually: put the files in place
~/.claude/skills/wp-block-themes/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/wp-block-themes/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-block-themes -a codex2Manually: put the files in place
.agents/skills/wp-block-themes/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-block-themes -a cursor2Manually: put the files in place
.cursor/skills/wp-block-themes/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install WordPress/agent-skills wp-block-themes2Manually: put the files in place
.github/skills/wp-block-themes/SKILL.md1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-block-themes -a gemini-cli2Platform CLI
gemini skills install https://github.com/WordPress/agent-skills --path skills/wp-block-themesManually: put the files in place
.devin/skills/wp-block-themes/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-block-themes -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set8
The whole set →Similar
Questions about wp-block-themes
How to install wp-block-themes in Claude Code?
Run npx skills add WordPress/agent-skills --skill wp-block-themes -a claude-code in your terminal.
What does the wp-block-themes skill do?
It helps agents safely edit theme.json, configure templates, and add style variations. It also troubleshoots why styling updates fail to show up in the Site Editor.
What are the environment requirements for wp-block-themes?
The environment must have Node.js and bash for directory detection scripts. The skill targets WordPress 7.0+ with PHP 7.4.0+, and several tasks require WP-CLI.