migrate-divi-to-gutenberg

Parse Divi shortcodes and generate Gutenberg block migration plans.

40|7|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/respira-press/agent-skills-wordpress --skill migrate-divi-to-gutenberg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-divi-to-gutenberg
Source: https://github.com/respira-press/agent-skills-wordpress/tree/main/skills/migrate-divi-to-gutenberg
Command: npx skills add https://github.com/respira-press/agent-skills-wordpress --skill migrate-divi-to-gutenberg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Divi stores content as shortcodes that must be translated into Gutenberg blocks for future-proof, semantic WordPress pages.

Core Features & Use Cases

  • Parses the Divi shortcode tree from post_content and preserves content, attributes, and nesting.
  • Maps Divi modules to Gutenberg blocks (e.g., et_pb_text to Paragraph, et_pb_image to Image, et_pb_button to Buttons) and generates a migration plan for review.
  • Creates draft duplicates in Gutenberg-ready format and writes to target posts/pages after approval.

Quick Start

Trigger the migration by saying migrate divi to gutenberg on a Divi-powered site to begin the workflow.

Frequently Asked Questions about migrate-divi-to-gutenberg

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Divi pages to Gutenberg blocks?

To migrate Divi pages to Gutenberg blocks, the Skill parses Divi shortcode-based content from post_content, maps each Divi module to its closest Gutenberg equivalent, and writes clean block markup to target posts. It connects to an MCP-enabled WordPress instance to create draft duplicates and ensure safe, non-destructive edits.

What is the best way to convert Divi shortcodes to Gutenberg block markup?

Converting Divi shortcodes to Gutenberg block markup is handled by extracting the module hierarchy and settings from the shortcode tree. The tool maps modules like et_pb_text to Paragraph blocks, generates an actionable migration plan for review, and then writes the clean block markup to your WordPress posts or pages.

Can I migrate Divi content to the block editor without losing my layout structure?

Migrating Divi content to the block editor preserves your layout structure by parsing the Divi shortcode tree to maintain content, attributes, and nesting. This ensures the module hierarchy is translated into corresponding nested Gutenberg blocks during the content migration process.

Does migrating Divi to Gutenberg require an MCP-enabled WordPress instance?

Migrating Divi to Gutenberg requires an MCP-enabled WordPress instance to create draft duplicates, verify permissions, and ensure safe, non-destructive edits. This connection allows the tool to write the generated Gutenberg-ready format directly to target posts or pages after approval.

How does Divi module mapping work when moving to the WordPress block editor?

Divi module mapping works by translating each shortcode module into its closest Gutenberg equivalent, such as et_pb_image to Image blocks or et_pb_button to Buttons. The process generates a migration plan that details these mappings for review before any block markup is written.

Are migrated Divi pages written directly to live WordPress posts or created as drafts?

Migrated Divi pages are created as draft duplicates in Gutenberg-ready format to ensure non-destructive edits. The clean block markup is only written to target posts or pages after you review the generated migration plan and approve the changes.