wp-block-themes

WordPress block theme development: theme.json, templates, patterns, and Site Editor troubleshooting. Use this skill for block theme work such as: If multiple themes exist, pick one and scope all changes to that theme root. If you are creating a new block theme from scratch (or converting a classic theme): Read: After creating the theme root, re-run detect_block_themes and continue below. Read: Decide whether you are changing: Read: Read: Prefer filesystem patterns under patterns/ when you want theme-owned patterns. Read: Style variations are JSON files under styles/ . Note: once a user picks a style variation, that selection is stored in the DB, so changing the file may not “update what the user sees” automatically. Read: Start with: Common issues: If upstream behavior is unclear, consult canonical docs: - Covers theme.json editing (presets, settings, per-block styles), templates and template parts, patterns, and style variations across WordPress 6.9+ - Includes triage scripts to detect theme roots and block theme structure, plus guided procedures for creating new themes or converting classic themes - Provides debugging workflows for style hierarchy issues, user customization overrides, and Site Editor reflection problems - Requires filesystem access with bash and Node; some workflows need WP-CLI - editing theme.json (presets, settings, styles, per-block styles) - adding or...