wp-block-themes

Manage and troubleshoot WordPress block themes via theme.json and templates.

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/zenbuapps/zenbu-powers --skill wp-block-themes-zenbuapps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-block-themes
Source: https://github.com/zenbuapps/zenbu-powers/tree/main/skills/wp-block-themes
Command: npx skills add https://github.com/zenbuapps/zenbu-powers --skill wp-block-themes-zenbuapps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

WordPress block theme development involves complex file structures (theme.json, templates, parts, patterns) and tricky Site Editor overrides. This Skill provides a structured workflow to configure, troubleshoot, and maintain block themes end-to-end.

Core Features & Use Cases

  • Triage and locate block theme roots using the provided scripts.
  • Manage theme.json settings, styles, templates, and parts for consistent themes across sites.
  • Debug style hierarchy and caching issues affecting the Site Editor and frontend.
  • Validate theme structure for single or multiple themes and ensure compatibility with WordPress 6.9+.

Quick Start

Run the triage script to locate theme roots and then follow the detect_block_themes workflow to start changes.

Frequently Asked Questions about wp-block-themes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot style hierarchy and caching issues in WordPress block themes?

Troubleshoot WordPress block themes by running a triage script to locate theme roots and debug the style hierarchy and caching behavior affecting the Site Editor and frontend. This resolves inconsistent visual overrides.

What is the correct way to manage theme.json settings for WordPress block themes?

Manage theme.json settings by defining the structure for styles, templates, and parts to ensure consistent block theme configurations across single or multi-theme WordPress sites. This standardizes global styling.

Does WordPress 6.9+ change how templates and parts folders work in block themes?

WordPress 6.9+ requires specific block theme structures for templates and parts folders to implement safe configurations. Validating your theme structure ensures compatibility with Site Editor workflows and newer features.

Why are my Site Editor template changes not showing on the frontend?

Site Editor template changes may not show due to style hierarchy overrides or caching behavior within block themes. Debugging the theme.json configuration and template parts resolves these frontend display issues.

Can I use the same block theme configuration for a multi-theme WordPress site?

You can configure block themes for a multi-theme WordPress site by managing theme.json settings, templates, and parts consistently. Validating theme structure ensures safe configurations across multiple themes.