Classic-to-Block Theme Migrator

Advanced WordPress Modernization

Modernize legacy WordPress workflows by transforming classic PHP-based themes into high-performance, Full Site Editing (FSE) block themes. This skill doesn't just shuffle files; it acts as a senior theme architect to restructure your entire site's architecture for the block era.

What it does

• Intelligent Extraction: Identifies business logic (CPTs, shortcodes, APIs) trapped in functions.php and migrates it to a dedicated companion plugin.
• Token-Based Design: Automatically derives a comprehensive theme.json (v3) from your existing CSS variables and Customizer settings.
• Template Conversion: Rewrites PHP templates (header, footer, index, single) into valid HTML block markup using wp: comments.
• Pattern Creation: Extracts repeating UI sections into discoverable, reusable Block Patterns.

Why use this skill?

Unlike basic AI prompting, this skill follows a strict architectural gate system. It prevents technical debt by enforcing design tokens over hardcoded values and ensuring content remains independent of the theme. You get a production-ready migration plan with risk ratings and a complete file set, not just snippets or advice.

Output & Tools

The skill produces structured project directories including templates/, parts/, and a {theme}-functionality plugin. It supports WordPress 6.4+ standards and integrates perfectly with modern developer tools like Claude Code or Cursor.