WordPress Structure Validator

Validate WordPress FSE theme structures and generate a structured validation report.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/theflysurfer/claude-skills-marketplace --skill wordpress-structure-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: WordPress Structure Validator
Source: https://github.com/theflysurfer/claude-skills-marketplace/tree/main/skills/julien-wordpress-structure-validator
Command: npx skills add https://github.com/theflysurfer/claude-skills-marketplace --skill wordpress-structure-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill validates WordPress FSE theme structure, including template hierarchy, theme.json, block styles, and content configuration.

Core Features & Use Cases

  • Template validation: confirms presence and naming of important templates
  • theme.json checks: validates color palette, typography, spacing
  • Block styles validation: ensures proper registration and usage
  • Content checks: ensures featured images and homepage templates are configured

Quick Start

Run validations against a theme path: bash scripts/validate_templates.sh /path/to/theme python scripts/check_theme_json.py /path/to/theme/theme.json

Frequently Asked Questions about WordPress Structure Validator

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

FAQPage Schema
How do I validate a WordPress FSE theme structure?

Validate WordPress FSE theme structure by running the included scripts against your theme path: `bash scripts/validate_templates.sh /path/to/theme` checks template hierarchy, and `python scripts/check_theme_json.py /path/to/theme/theme.json` validates configuration. The Skill generates a structured validation report covering templates, theme.json, block styles, and content configuration.

What does theme.json validation check in WordPress?

Theme.json validation checks color palettes, typography settings, spacing values, and overall configuration structure. This ensures your FSE theme's design tokens and block editor settings are properly configured and compatible with WordPress block themes.

Can I validate block styles registration in my WordPress theme?

Yes, block styles validation confirms proper registration and usage of custom block styles in your FSE theme. The Skill includes `check_block_styles.sh` to audit block style definitions and ensure they're correctly integrated with your theme structure.

When should I run WordPress theme structure validation?

Run validation during theme development, before deployment, during audits, and when migrating themes between WordPress environments. It's essential for confirming template hierarchies, featured image configuration, and homepage template setup are correct before going live.

What file permissions does the theme validator check?

The Skill audits file permissions as part of its comprehensive validation, ensuring your FSE theme files have appropriate read/write permissions for WordPress and web server access. This prevents permission-related deployment issues.

Does theme validation work with migration tools like UpdraftPlus?

Yes, the Skill includes UpdraftPlus checks as part of its validation suite, ensuring your FSE theme structure remains valid after backup, restoration, or migration operations using UpdraftPlus.