The Divi Claude Skill
A free Claude Skill that teaches Claude the safe, composable patterns for editing Divi pages via AI — clone-and-retarget, library-to-page templates, library CRUD, Divi 4 to Divi 5 migration prep, and Divi 5 authoring from scratch. Handles Divi 4 shortcodes and Divi 5 blocks uniformly. Copy the instructions or download the file, drop it into Claude Desktop or Claude in browser, and your next Divi edit works cleanly on the first try.
Then in Claude: Settings → Skills → Add → Write skill instructions (paste) or Upload a skill (drop the file).
Get Royal MCP free from WordPress.org
This skill teaches Claude how to use Royal MCP's Divi tools intelligently — page format detection, library work, page cloning, image and text swaps, library CRUD, Divi 4 to Divi 5 migration prep, and Divi 5 authoring. Without Royal MCP installed on your WordPress site, Claude will know the workflows but can't execute them. Install it first — two-minute install, no configuration required, free forever.
Get Royal MCP free from WordPress.orgThree steps, two minutes
Once Royal MCP is active on your WordPress site (see above), loading the skill takes about two minutes. Exactly the flow Anthropic ships their own skills through — same Add menu, same paste-or-upload options.
Copy or download
Click Copy skill instructions or Download Divi Claude Skill at the top of this page. That's the whole file — no zip, no repo, no dependencies.
Open Claude's Skills settings
In Claude Desktop or Claude in your browser, open Settings → Skills. Click the Add button at the top-right.
Paste or upload
Choose Write skill instructions and paste the copied content, or Upload a skill and drop the .md file. Save. Claude will auto-load it whenever you ask about Divi.
Five workflows Claude will follow
The skill teaches Claude one thing: detect page format first, never invent Divi content from scratch. Every workflow starts with the page-format probe (Divi 4 vs Divi 5 vs mixed vs not-Divi) and reads the per-post builder version from postmeta — never inferred from theme version. Every destructive write emits a 72-hour undo token visible in the response text.
Clone and retarget
Duplicate an existing Divi page as a new draft — all _et_pb_* meta preserved, D5 clientIds regenerated, D4 shortcodes pre-validated. Then bulk-substitute city, brand, or product references across shortcode attributes and block content. Independent undo tokens per write.
Library-to-page bridge
List saved Divi Library items, inspect their format (D4 shortcode or D5 block), and apply them to any target page in merge mode (append top/bottom) or replace mode (with backup meta stamp). Format-mismatch warnings surface before the write.
Library CRUD
Create, update, and delete Divi Library items with explicit D4/D5 format declaration (no auto-detect — prevents silent mismatched saves). Global module deletion refuses when the module is in use unless you force it — because forcing it breaks every page that referenced the module.
Divi 4 to Divi 5 migration prep
Audit which pages are D4 shortcode, D5 block, or mixed. Optionally back up D4 post_content to a recoverable meta key. Elegant Themes has not published a programmatic D4-to-D5 conversion API, so the actual migration is Divi's own admin UI — this prep tool audits + backs up + surfaces the admin URL so nothing goes wrong when you click it.
Divi 5 authoring from scratch
Emit ready-to-write Divi 5 block markup for code, text, and heading modules. Enforces the semver builder_version guard so your module doesn't silently render blank (the #1 cause of empty D5 bodies), detects the double-quote-in-content gotcha, and optionally writes atomically with a 72-hour undo token.
The skill file, verbatim
Exactly what gets pasted into Claude when you click Copy above — nothing hidden, nothing bundled. Scroll to read; or just copy and paste it into Claude to try.
divi-mcp.md
Loading skill content…
Common questions
I don't have Royal MCP installed yet — can I try this skill first?
I'm on Divi 4 — will this skill work, or is it Divi 5 only?
I asked Claude to edit my Divi site before and it clobbered a page — what changed?
word_count 0). The skill teaches Claude the whole recovery sequence.Can I use this to author brand-new Divi 5 content programmatically?
code, text, and heading modules via the Divi 5 scaffold tool. It collapses Divi 5's five-requirement authoring wrapper (placeholder root, builderVersion on every block, per-breakpoint content shape, row/column structure attrs, single-quote HTML policy) into a single call with a semver-versioning guard so your block doesn't silently render blank. Note: JSON-LD structured data can't go inside a Divi 5 Code module — the double quotes terminate the block attribute. Use schema.org microdata instead. The skill teaches Claude both the authoring pattern and the JSON-LD workaround.I use Elementor (or Bricks, or Oxygen) — does this skill work on my site?
Claude told me to upgrade to Royal MCP Pro for cloning or library work — can I do it with Free?
How do I prepare my Divi 4 site for a Divi 5 upgrade?
post_content into recoverable meta keys before migration, then click Divi's own admin migration button. Important honesty: Elegant Themes has not published a programmatic D4-to-D5 migration API, so the actual conversion is Divi's own admin UI. The skill audits + backs up + surfaces the admin URL — it does not migrate for you. Backup gives you a 72-hour undo lane if Divi's migration hits edge cases.