- Home
- Skills
- Code Quality & Review
- Classic-to-Block Theme Migrator
More screenshots
Works with the AI Agents you already use
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.
$22.99
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
| # | File | Bucket | Impact | Effort | Score |
|---|---|---|---|---|---|
| 1 | footer.php | AUTO | 5 | 1 | 25.0 |
| 2 | header.php | AUTO | 5 | 2 | 12.5 |
| 3 | page.php | AUTO | 3 | 1 | 9.0 |
| 4 | index.php | AUTO | 4 | 2 | 8.0 |
| 5 | single.php | AUTO | 4 | 2 | 8.0 |
| 6 | functions.php | PLUGIN (partial) | 4 | 3 | 5.3 |
| 7 | archive.php | AUTO | 3 | 2 | 4.5 |
| 8 | single-project.php | MANUAL | 4 | 5 | 3.2 |
| 9 | 404.php | AUTO | 1 | 1 | 1.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
| Code | Target | Rewrite flush |
|---|---|---|
register_post_type('project') | inc/post-types.php | Yes, on activation |
add_shortcode('team') | inc/shortcodes.php | No |
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.
Connects securely to your tools. The creator never sees your data.
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.phpand migrates it to a dedicated companion plugin. - Token-Based Design: Automatically derives a comprehensive
theme.jsonfrom your existing CSS variables and Customizer settings, matched to your WordPress version (version 3 on WP 6.6+, version 2 on WP 5.9–6.5). - 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 5.9+ block themes and works with modern developer tools like Claude Code or Cursor.
- Cannot auto-convert Page Builder content (Elementor/Divi).
- Complex ACF logic requires manual review.
- Custom PHP loops in templates may need refactoring into blocks.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
This skill has been used 1 time.
Trust & safety
Security scan
Security scan passed 15 days ago
Permissions
No special permissions declared or detected