Wp Block Themes

Handles the full filesystem layer of WordPress block theme development: theme.json editing for global settings and styles, template and template part HTML, pattern registration, and style variations. It triages your project to locate theme roots, then guides you through the correct folders and schema depending on your WordPress version target. The skill is opinionated about the style hierarchy (core defaults, theme.json, child theme, user customizations) and explicitly calls out the most common footgun: user customizations in the database silently overriding your theme.json changes. If you're debugging "why aren't my styles applying" or need to add a template part without breaking the Site Editor, this walks you through the filesystem structure and WordPress 6.9+ expectations.

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

View on GitHub

Install

$ npx -y skills add wordpress/agent-skills --skill wp-block-themes --agent claude-code

Installs into .claude/skills of the current project.

Files

WP Block Themes

When to use

Use this skill for block theme work such as:

editing theme.json (presets, settings, styles, per-block styles)
adding or changing templates (templates/*.html) and template parts (parts/*.html)
adding patterns (patterns/*.php) and controlling what appears in the inserter
adding style variations (styles/*.json)
debugging “styles not applying” / “editor doesn’t reflect theme.json”

Inputs required

Repo root and which theme is targeted (theme directory if multiple exist).
Target WordPress version range (theme.json version and features vary by core version).
Where the issue manifests: Site Editor, post editor, frontend, or all.

Procedure

0) Triage and locate block theme roots

Run triage:
- node skills/wp-project-triage/scripts/detect_wp_project.mjs
Detect theme roots + key folders:
- node skills/wp-block-themes/scripts/detect_block_themes.mjs

If multiple themes exist, pick one and scope all changes to that theme root.