Skill · WordPress & Dev

Classic-to-Block Theme Migrator

The only classic-to-FSE migration skill that extracts business logic into a companion plugin during conversion — delivering a phased, reversible plan AND the actual converted files, not a tutorial.

Category
WordPress & Dev
Deliverable
1 .skill bundle
Outputs
6
Last updated
15 Jun 2026
$22.99 One-time · lifetime updates
  • Works in Claude Pro, Team, and Enterprise
  • Lifetime access to updates
  • Refundable for 30 days via the marketplace
Or get a free skill every month. Subscribers get one curated skill, free, every 1st. Pick yours →

StrategistKit Affiliate. Purchase happens on the marketplace, which handles payment, delivery and refunds.

Overview

What Classic-to-Block Theme Migrator does.

Classic-to-Block Theme Migrator runs in two modes. In ASSESS mode, it reads your classic theme file by file, classifies every template as auto-convertible, manual, or business-logic-that-belongs-in-a-plugin, scores each file by impact and effort, and returns a four-phase reversible migration plan with per-file risk ratings. In MIGRATE mode it produces the actual converted files: a valid theme.json with all design tokens mapped from your CSS variables and Customizer settings, converted template parts, Query Loop replacements for every classic loop, pattern files with correct Block Pattern headers, and a companion plugin scaffold that pulls CPTs, taxonomies, shortcodes, and REST endpoints cleanly out of the theme.

A typical input is a pasted or described classic theme directory — style.css, header.php, footer.php, functions.php, single.php, archive.php, and any page-specific templates — plus notes on whether CPTs, ACF field groups, or custom REST routes are present. The skill calibrates to whatever WordPress version is in use, flags any page-builder templates as out-of-scope manual work, and keeps the classic theme as a tagged git fallback throughout. No specific niche is assumed; the buyer supplies the actual theme and its business context.

A MIGRATE response for a theme with a registered CPT and custom loop would include, among other files: a complete theme.json (version 3 schema, WP 6.4+) with every palette color and font size as a named slug; parts/header.html showing the exact header.php-to-block-markup transformation; templates/archive.html with a Query Loop block and all child blocks (post-featured-image, post-title, post-excerpt, post-date, pagination) in place of The Loop; and a {theme-slug}-functionality plugin scaffold registering the CPT and its REST endpoint, with an explanation of what was extracted and why.

Who it's for

WordPress developers and agencies inheriting or maintaining classic PHP themes who need to deliver a production-safe FSE migration — not a tutorial to follow, but actual converted files and a structured plan they can hand to a client or commit to version control. Particularly valuable when the theme mixes presentation with CPT registration, shortcodes, or custom REST endpoints that would break if left inside the theme.

What you get

One skill. 6 outputs.

One .skill bundle. Run it on your material and it returns:

01

ASSESS mode: A scored, per-file inventory of your classic theme — every template classified (auto-convertible / manual / business-logic-to-plugin) with a four-phase reversible migration plan, risk register, and go/no-go recommendation.

02

MIGRATE mode: The actual converted files — complete theme.json, converted template parts, templates with Query Loop, pattern files with correct headers, a companion plugin scaffold, and an updated functions.php — delivered as ready-to-paste fenced code blocks.

03

A complete, valid theme.json for WP 6.4+ (version 3 schema) with all design tokens properly mapped.

04

Side-by-side header.php → parts/header.html conversion so you see the exact transformation logic.

05

Classic loop → Query Loop block conversion with all child blocks (post-featured-image, post-title, post-excerpt, post-date, pagination).

06

Pattern file scaffold with every required Block Pattern header field explained.

How it works

Three steps. About two minutes.

Install

Add the .skill file to your Claude app. ~10 seconds.

Run it on your work

Invoke the skill and paste in your material.

Apply the output

Review, keep what works, and use it.

In depth

Why a Claude skill beats a prompt template.

A copy-paste prompt runs one static pass and stops. A skill is a bundled program — instructions, examples, and a workflow Claude runs as a unit: it asks for the right input, applies the same pattern every time, and returns the structured outputs above.

FAQ

Common questions.

What files do I need to provide as input?

At minimum, list the files present in the theme directory — style.css, header.php, footer.php, functions.php, index.php, and any page-, single-, or archive-specific templates. If you can paste the file contents, the skill converts them directly; if you can only describe the structure, it works from the canonical classic-theme file set and flags assumptions explicitly.

Does it produce ready-to-use code or pseudocode I still have to write?

MIGRATE mode returns ready-to-paste fenced code blocks: a complete theme.json, .html template parts and templates, .php pattern files with all required Block Pattern header fields, and a companion plugin scaffold. The output is meant to be dropped into a theme directory and tested, not used as a writing prompt.

What happens to CPT registration and shortcodes that are currently in functions.php?

Extracting that code to a companion plugin is a mandatory gate in the migration, not an optional step. The skill identifies every non-presentation item in functions.php, moves it to a {theme-slug}-functionality plugin scaffold in the output, and leaves only enqueue logic and theme-specific hooks behind. This ensures the business logic survives a future theme switch.

Can it handle themes that use Elementor, Divi, or another page builder?

Page-builder templates are flagged as manual work and excluded from auto-conversion scope. The skill will note which templates are affected and explain why they cannot be mechanically converted, but it does not attempt to produce block equivalents for page-builder markup.

How does the phased plan work, and can I run only one phase?

The ASSESS output breaks the migration into four independently deployable phases, each with its own go/no-go condition. Every phase is designed to be rollback-able to the tagged classic theme fallback. You can stop after any phase without leaving the site in a broken state, which makes it practical to migrate in sprints rather than in a single deployment.

More in WordPress & Dev

Skills used with this one.