# Wp Theme Development

> WordPress theme review for Codex. Use when reviewing block themes, classic themes, or hybrid themes for theme.json structure, templates, template parts, style variations, global styles, and FSE patterns.

- Skill: `jorgerosal/wp-theme-development` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jorgerosal/wp-theme-development`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jorgerosal/wp-theme-development/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jorgerosal (https://skillmd.com/u/jorgerosal)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jorgerosal/wp-theme-development

---


# Codex WordPress Theme Development Review

## Purpose

Use this skill when Codex needs to review WordPress theme code, especially `theme.json`, template structure, Full Site Editing patterns, and classic-to-block migration concerns.

## Focus Areas

- Theme type detection: block, classic, hybrid, or child theme
- `theme.json` structure and versioning
- Template hierarchy and required files
- Template parts, block markup, and pattern registration
- Global styles, spacing systems, and style variations
- Migration or compatibility issues between classic and block approaches

## Workflow

1. Detect the theme type and review context first.
2. Validate `theme.json`, required files, and template structure.
3. Check template parts, patterns, style variations, and global style choices.
4. Use shared reference docs for deeper checks only where needed.
5. Report findings with severity, file references, and theme-specific remediation guidance.

## Reference Files

Load only the references you need from:

- `../../claude-skills/wp-theme-development/references/theme-json-guide.md`
- `../../claude-skills/wp-theme-development/references/template-patterns.md`
- `../../claude-skills/wp-theme-development/references/fse-guide.md`
- `../../claude-skills/wp-theme-development/references/classic-to-block-guide.md`

## Output

- Group findings by severity
- Include file references across PHP, HTML, and JSON files
- Explain whether the issue affects block themes, classic themes, or both
- Suggest fixes that match current WordPress theme conventions