Works with the AI tools you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIGitHub CopilotGitHub CopilotGemini CLIGemini CLI+20 more

    Classic-to-Block Theme Migrator

    2

    Token-Based Design: Automatically derives a comprehensive theme.json (v3) from your existing CSS variables and Customizer settings.

    $22.99

    Secure checkout via Stripe

    30-day refund guarantee

    Converts to your local currency at checkout

    1 install5.0 (1 review)
    Classic-to-Block Theme Migrator

    Classic-to-Block Theme Migrator

    Example session with this skill installed

    We want to move a classic theme for a small architecture studio to a block theme on WP 6.6. Files: header.php, footer.php, index.php, single.php, page.php, archive.php, 404.php, single-project.php (ACF gallery repeater), and functions.php, which registers a "project" CPT and a [team] shortcode.

    • Read your context and instructions
    • Compiled the classic-to-block theme migrator

    Mode: ASSESS. Straightforward migration: 5 of 6 templates are AUTO (83%), with one MANUAL template and two items for the companion plugin.

    Inventory

    #FileBucketImpactEffortScore
    1footer.phpAUTO5125.0
    2header.phpAUTO5212.5
    3page.phpAUTO319.0
    4index.phpAUTO428.0
    5single.phpAUTO428.0
    6functions.phpPLUGIN (partial)435.3
    7archive.phpAUTO324.5
    8single-project.phpMANUAL453.2
    9404.phpAUTO111.0

    Phases

    • 0: Tag the classic theme in git, enable WP_DEBUG.
    • 1: Scaffold, derive theme.json from CSS, convert header and footer parts.
    • 2: Convert the AUTO templates, Query Loop in index and archive.
    • 3: Rebuild single-project; move CPT and shortcode to the plugin.
    • 4: Visual parity review, then archive the classic theme.

    Plugin extraction

    CodeTargetRewrite flush
    register_post_type('project')inc/post-types.phpYes, on activation
    add_shortcode('team')inc/shortcodes.phpNo

    Risk: the ACF gallery repeater has no direct block equivalent. Use a dynamic block or ACF block in the plugin.

    Next steps

    • Activate the plugin before switching themes so projects stay visible.
    • Tell me to start MIGRATE mode with theme.json and the header part.
    Scaffold, derive theme.json

    Connects securely to your tools. The creator never sees your data.

    What you get

    Extract CPTs and business logic from themes into standalone functionality plugins.Generate a valid theme.json derived from legacy CSS variables and design tokens.Convert PHP loops and template tags into modern WordPress Query Loop blocks.Turn repeated theme sections into discoverable, categorized Block Patterns.

    About this skill

    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.

    How to install

    Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.

    ~30 seconds
    1. 1

      Download the ZIP

      Free skills download straight away. Paid skills unlock right after purchase.

    2. 2

      Unzip into your skills folder

      Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.

    3. 3

      Ask your agent to use it

      Restart the agent if it was already running. It picks the skill up automatically - no config needed.

    Skills folder by agent

    Click the path to copy it. Create the folder if it does not exist yet.

    Reviews

    5.0
    1 review
    5
    1
    4
    0
    3
    0
    2
    0
    1
    0

    1 people have installed this skill.

    Trust & safety

    Security scanned

    Verified clean 3 months ago

    • Passed all security checks, Safe to install

    Listed3 months ago
    Updated11 days ago

    What's inside

    Frequently Asked Questions