What it does
Use when developing WordPress block themes: theme.json (global settings/styles), templates and template parts, patterns, style variations, and Site Editor troubleshooting (style hierarchy, overrides, caching).
Install
This skill ships in WordPress/agent-skills (Official, WordPress core fundamentals).
One command installs it for any assistant. Run this from your project root:
npx skills add WordPress/agent-skills --skill wp-block-themesYou'll be asked to choose a scope: project (shared with your team, committed to version control) or global (available across all your projects). Add --global to skip the prompt and install globally.
Use it in your AI assistant
The destination folder, and how the assistant discovers it, differs per tool:
Claude Code
.claude/skills/wp-block-themes/ (or ~/.claude/skills/wp-block-themes/ for all projects)
- Claude Code auto-discovers skills in .claude/skills/ (project) or ~/.claude/skills/ (global, every project).
- Claude reaches for the skill on its own when a task matches its description, or you can name it directly.
GitHub Copilot (VS Code)
.github/skills/wp-block-themes/
- The skill is copied into .github/skills/wp-block-themes/, where Copilot in VS Code picks it up.
- Copilot Chat applies it automatically once your task matches the skill's description.
OpenAI Codex
.codex/skills/wp-block-themes/
- This installs the skill to .codex/skills/wp-block-themes/, which Codex reads for standing instructions on matching tasks.
- Point Codex at it directly if needed: "follow .codex/skills/wp-block-themes/SKILL.md for this task."
Cursor
.cursor/skills/wp-block-themes/ (or ~/.cursor/skills/wp-block-themes/ globally)
- Cursor discovers skills in .cursor/skills/ (project) or ~/.cursor/skills/ (global).
- Cursor loads it automatically when a request matches, same as its native Rules.
Compatibility
Targets WordPress 7.0+ (PHP 7.4.0+). Filesystem-based agent with bash + node. Some workflows require WP-CLI.