wp-block-themes

What problem does it solve?

This Skill helps WordPress developers streamline block-theme creation and debugging by guiding how to configure theme.json, manage templates and template parts, create patterns, and handle style variations, while addressing Site Editor challenges such as style hierarchy and caching.

Core Features & Use Cases

• Theme.json configuration: control global styles and per-block settings to ensure consistency across editor and frontend.
• Templates and template parts: manage templates/.html and parts/.html to drive Site Editor experiences.
• Patterns and style variations: create patterns in patterns/* and variations in styles/* to offer design options and maintain consistency.
• Troubleshooting: diagnose style inheritance and caching issues across core defaults, theme.json, and user customizations.
• Use Case: A developer prototyped a new block theme, wired up editor controls, and validated rendering in Site Editor and frontend.

Quick Start

Start by identifying the theme root using node skills/wp-project-triage/scripts/detect_wp_project.mjs, then locate block-theme roots with node skills/wp-block-themes/scripts/detect_block_themes.mjs. If multiple themes exist, pick one and scope all changes to that theme root. Then edit theme.json, templates, parts, patterns, and styles as guided by this skill.