Creative & DesignBeginner
wp-block-themes
Block themes: theme.json, templates, patterns, style variations
Developer Setup
Setup & Installation
bash
npx skills add https://github.com/WordPress/agent-skills --skill wp-block-themesnpx skills add https://github.com/WordPress/agent-skills --skill wp-block-themesOr paste this URL into your assistant to install:
Overview
What This Skill Does
Block themes: theme.json, templates, patterns, style variations
Application
When to use this Skill
- Integrating wp block themes into your development workflow.
- Following best practices for block themes: theme.
- Automating repetitive tasks with AI-assisted tooling.
- Building production-grade applications with proper standards.
- Debugging and troubleshooting common implementation issues.
Documentation
Show Skills.md file
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:
Lines 1 - 25 of 110
Recommendations