Wp Block Themes

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).

211 stars 37 forksFrontend & Design

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Automattic/agent-skills --skill wp-block-themes
Manual install
git clone --depth 1 https://github.com/Automattic/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/wp-block-themes ~/.claude/skills/wp-block-themes

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 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

1. Run triage:
   - `node skills/wp-project-triage/scripts/detect_wp_project.mjs`
2. 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.

### 1) Create a new block theme (if needed)

If you are creating a new block theme from scratch (or converting a classic theme):

- Prefer starting from a known-good scaffold (or exporting from a WP environment) rather than guessing file layout.
- Be explicit about the minimum supported WordPress version because `theme.json` schema versions differ.

Read:
- `references/creating-new-block-theme.md`
Read the full skill on GitHub

Details

Skill name
wp-block-themes
Path
skills/wp-block-themes/SKILL.md
Repo updated
1 February 2026
Copies
Found in 2 GitHub repos

FAQ

What does the Wp Block Themes skill do?

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).

How do I install the Wp Block Themes skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add Automattic/agent-skills --skill wp-block-themes. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Wp Block Themes popular?

It lives in Automattic/agent-skills, which has 211 GitHub stars and 37 forks.

Related skills

Wp Abilities API

211

Automattic/agent-skills

Use when working with the WordPress Abilities API (wp_register_ability, wp_register_ability_category, /wp-json/wp-abilities/v1/*, @wordpress/abilities) including defining abilities, categories, meta, REST exposure, and permissions checks for clients.

Software Development37

Wp Block Development

211

Automattic/agent-skills

Use when developing WordPress (Gutenberg) blocks: block.json metadata, register_block_type(_from_metadata), attributes/serialization, supports, dynamic rendering (render.php/render_callback), deprecations/migrations, viewScript vs viewScriptModule, and @wordpress/scripts/@wordpress/create-block build and test workflows.

Software Development37

Wp Interactivity API

211

Automattic/agent-skills

Use when building or debugging WordPress Interactivity API features (data-wp-* directives, @wordpress/interactivity store/state/actions, block viewScriptModule integration, wp_interactivity_*()) including performance, hydration, and directive behavior.

Software Development37

Wp Project Triage

211

Automattic/agent-skills

Use when you need a deterministic inspection of a WordPress repository (plugin/theme/block theme/WP core/Gutenberg/full site) including tooling/tests/version hints, and a structured JSON report to guide workflows and guardrails.

Frontend & Design37

Sylph Setup

220

getnao/sylph

Personalize Sylph to your company. Ask the company name, then derive everything from the web - CONTEXT.md, brand voice, team, ICP, and standing instructions.

Frontend & Design67

Wpds

211

Automattic/agent-skills

Use when building UIs leveraging the WordPress Design System (WPDS) and its components, tokens, patterns, etc.

Frontend & Design37

Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.