wp-block-themes

Detect WordPress block theme roots and validate theme.json structure.

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/javiercasares/cloudfest-wporgdownload --skill wp-block-themes-javiercasares
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-block-themes
Source: https://github.com/javiercasares/cloudfest-wporgdownload/tree/main/.claude/skills/wp-block-themes
Command: npx skills add https://github.com/javiercasares/cloudfest-wporgdownload --skill wp-block-themes-javiercasares

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill guides developers in configuring and debugging WordPress block themes, including theme.json, templates, parts, patterns, and style variations, to ensure consistent editor and frontend styling.

Core Features & Use Cases

  • Theme root detection and triage to identify the active block theme root.
  • Theme.json validation and safe edits for global settings and per-block styling.
  • Templates and template parts setup, including patterns and style variations management.
  • End-to-end verification workflow to ensure Site Editor and frontend rendering align with theme.json.

Quick Start

  • Locate the block theme root using the provided triage workflow: node skills/wp-block-themes/scripts/detect_block_themes.mjs
  • Verify the presence of theme.json, templates/, and parts/ directories; adjust as needed.
  • If starting a new block theme, follow references/creating-new-block-theme.md to establish a minimal structure (style, theme.json, templates/index.html, parts/header.html, parts/footer.html) and re-run detection.

Frequently Asked Questions about wp-block-themes

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

FAQPage Schema
How do I debug WordPress block theme configuration issues?

Debug WordPress block theme configuration by triaging the active theme root, validating theme.json structure, and guiding safe edits to templates and parts. This ensures consistent editor and frontend styling across your site.

How do I set up a minimal WordPress block theme structure?

Set up a minimal WordPress block theme by creating the required structure: style.css, theme.json, templates/index.html, parts/header.html, and parts/footer.html. Follow the provided references to establish and verify this baseline.

How do I validate theme.json structure for global settings and per-block styling?

Validate theme.json structure by checking global settings and per-block styling definitions within the file. This process guides safe edits to ensure the Site Editor and frontend rendering align correctly.

Why does my WordPress block theme render differently in the editor than on the frontend?

WordPress block themes render differently due to misaligned theme.json settings or template configurations. Running an end-to-end verification workflow detects these mismatches and guides safe edits to synchronize editor and frontend styling.

What do I need to manage WordPress block theme templates, parts, patterns, and style variations?

Managing WordPress block theme templates, parts, patterns, and style variations requires locating the theme root and verifying directory structures. This guides triage, root detection, and safe edits across all configuration files.

Can I use a script to detect active WordPress block themes?

You can detect active WordPress block themes by running the provided script to locate the theme root. This triage workflow verifies the presence of theme.json, templates, and parts directories to ensure correct configuration.