wp-block-themes

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: - editing theme.json (presets, settings, styles, per-block styles) - adding or changing templates ( templates/*.html ) and template parts ( parts/*.html ) - adding patterns ( patterns/*.php ) and controlling what appears in the inserter - adding style variations ( styles/*.json ) - debugging “styles not applying” / “editor doesn’t reflect theme.json” - Repo root and which theme is targeted (theme directory if multiple exist). - Target WordPress version range (theme.json version and features vary by core version). - Where the issue manifests: Site Editor, post editor, frontend, or all.