wp-block-themes

Manage theme.json settings, templates, and patterns for WordPress block themes.

27|1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/dr-robert-li/cowork-wordpress-expert --skill wp-block-themes-dr-robert-li
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-block-themes
Source: https://github.com/dr-robert-li/cowork-wordpress-expert/tree/main/references/wp-block-themes
Command: npx skills add https://github.com/dr-robert-li/cowork-wordpress-expert --skill wp-block-themes-dr-robert-li

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires wp-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the development and troubleshooting of modern WordPress block themes, addressing issues with theme configuration, templating, and styling.

Core Features & Use Cases

  • theme.json Management: Edit global styles, settings, and block-specific configurations.
  • Template & Part Development: Create and modify theme templates and reusable template parts.
  • Pattern Creation: Develop and manage reusable content patterns.
  • Style Troubleshooting: Debug style hierarchy, overrides, and Site Editor inconsistencies.
  • Use Case: You're building a new block theme and need to define a consistent color palette and typography scale across all blocks using theme.json, then create custom templates for your post types.

Quick Start

Use the wp-block-themes skill to edit the theme.json file for the 'my-theme' theme.

Frequently Asked Questions about wp-block-themes

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

FAQPage Schema
How do I manage theme.json settings for a WordPress block theme?

You manage theme.json settings by editing global styles, settings, and block-specific configurations to establish consistent visual elements across your WordPress block theme.

How do I create custom templates and reusable template parts for block themes?

You create custom templates and reusable template parts by developing and modifying theme files directly. This allows you to define distinct structural layouts for various post types within the WordPress site editor.

Does WordPress block theme development require WP-CLI?

WordPress block theme development requires WP-CLI for certain workflows. You need this command-line interface installed to execute specific management commands for templates and patterns.

What is the best way to debug Site Editor style inconsistencies in block themes?

The best way to debug Site Editor style inconsistencies is to troubleshoot the style hierarchy and overrides configured in theme.json. This resolves conflicts between global settings and block-specific styles.

How do I develop reusable content patterns for WordPress 6.9+?

You develop reusable content patterns by creating and managing pattern files within your block theme directory. This provides predefined layouts that users can insert and reuse in the site editor.

Why are my block theme styles not overriding default WordPress settings?

Block theme styles fail to override defaults when the style hierarchy in theme.json is misconfigured. You must troubleshoot the style hierarchy and overrides to ensure block-specific configurations take precedence.