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).
Install
npx skills add Automattic/agent-skills --skill wp-block-themesgit 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-themesPersonal 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`
Details
- Skill name
wp-block-themes- Repository
- Automattic/agent-skills
- 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
211Automattic/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.
Wp Block Development
211Automattic/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.
Wp Interactivity API
211Automattic/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.
Wp Project Triage
211Automattic/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.
Sylph Setup
220getnao/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.
Wpds
211Automattic/agent-skills
Use when building UIs leveraging the WordPress Design System (WPDS) and its components, tokens, patterns, etc.
Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.