skills.rest
MrGKanev
MrGKanevCOMMUNITY
Explore all skills by this author →
Website𝕏@mrgkanevGitHub

wp-block-themes

Locate and validate WordPress block theme structures with a node-based detection script.

Updated Jan 13, 2026
Search Tags:#templates#troubleshooting#wordpress#block-themes#site-editor#theme-json#block-theme-development
One-click install
npx skills add https://github.com/MrGKanev/agent-skills --skill wp-block-themes-mrgkanev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wp-block-themes
Source: https://github.com/MrGKanev/agent-skills/tree/main/skills/wp-block-themes
Command: npx skills add https://github.com/MrGKanev/agent-skills --skill wp-block-themes-mrgkanev

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill guides developers through WordPress block theme development and troubleshooting, focusing on organizing theme.json settings, templates, parts, patterns, and style variations to ensure consistent Site Editor behavior.

Core Features & Use Cases

  • Guided triage of block theme roots to locate theme.json, templates, parts, and styles.
  • Validation and debugging of theme.json, template placement, and style hierarchies to fix editor/frontend discrepancies.
  • Structured workflow for creating or modifying block themes across WordPress 6.9+ environments.

Quick Start

From the repository root, run node skills/wp-block-themes/scripts/detect_block_themes.mjs to identify the active theme. Then inspect the theme's templates/parts to confirm structure, review theme.json with references/theme-json.md, and apply the recommended debugging steps.

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 WordPress block theme structure issues?▼

To troubleshoot WordPress block theme structure issues, run a node-based detection script to scan theme roots, validate theme.json settings, and inspect templates and parts to resolve editor and frontend rendering discrepancies.

What is a WordPress block theme and how does theme.json work?▼

A WordPress block theme uses theme.json to manage global styles and settings, organizing templates, parts, patterns, and style variations to ensure consistent Site Editor behavior across WordPress 6.9+ environments.

How do I validate theme.json and template placement in a block theme?▼

Validate theme.json and template placement by running a detection script to locate the active theme, confirming the structure of templates and parts, and applying structured debugging steps to fix Site Editor discrepancies.

Does this block theme troubleshooting workflow require Node.js?▼

Yes, this block theme troubleshooting workflow requires Node.js to execute the detection script that scans theme roots and identifies the active WordPress block theme structure.

Why does my WordPress block theme look different in the Site Editor than on the frontend?▼

Block theme editor and frontend discrepancies often stem from invalid theme.json settings or misplaced template parts, which you can diagnose by scanning theme roots and validating style hierarchies.

Related Skills

Explore More Software Engineering Skills→
josecontijoseconti
2

wordpress-theme-customizer

Detect active WordPress theme type and configure its appearance and behavior.

Community
Advanced
zenbuappszenbuapps

wp-block-themes

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

Official
Intermediate
ihatesea69ihatesea69
3

wp-block-themes

Manage theme.json configurations and debug WordPress block themes.

Community
Intermediate
HungNthHungNth

wp-block-themes

Automates WordPress block theme development and debugging via bash and Node.js.

Community
Advanced