**Version:** 2.0.0 **Updated:** 2026-06-30 **Freshly updated:** v2.0.0 weaves in the current Respira safety and precision flow — `respira_find_builder_targets` to inventory and scope the Divi source pages up front, a `respira_get_snapshot` checkpoint before any write, and
Installs just this skill. Get the whole plugin for auto-invocation.
⚡ How it fires
How this skill gets triggered: by you, by Claude, or both.
Fires itselfClaude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/migrate-divi-to-breakdance
👁️ Context preview
The summary Claude sees to decide when to auto-load this skill.
**Version:** 2.0.0 **Updated:** 2026-06-30 **Freshly updated:** v2.0.0 weaves in the current Respira safety and precision flow — `respira_find_builder_targets` to inventory and scope the Divi source pages up front, a `respira_get_snapshot` checkpoint before any write, and
# Migrate Divi to Breakdance
**Version:** 2.0.0
**Updated:** 2026-06-30
**Freshly updated:** v2.0.0 weaves in the current Respira safety and precision flow — `respira_find_builder_targets` to inventory and scope the Divi source pages up front, a `respira_get_snapshot` checkpoint before any write, and surgical fixes via `respira_find_element` + `respira_update_element` (and `respira_batch_update` for multi-element or multi-page corrections) instead of re-injecting whole pages. Rollback is now explicit (restore the snapshot, delete the draft duplicates). Reflects the current 16 supported builders.
Converts Divi-built WordPress pages to Breakdance Builder. Parses Divi's shortcode-based content from post_content, maps each module to its Breakdance element equivalent, generates a migration plan for approval, and writes Breakdance content to the target pages. Use this skill whenever someone wants to move from Divi to Breakdance, switch builders from Divi to Breakdance, or rebuild Divi pages in Breakdance.
## What This Skill Does
Divi and Breakdance take very different approaches to content storage — Divi uses nested shortcodes in `post_content`, while Breakdance uses a structured format in post meta. This skill bridges that gap by parsing the full Divi shortcode tree, understanding each module's intent, and recreating it as the appropriate Breakdance element. Breakdance was built by the Oxygen team with a focus on clean output and intuitive editing, making it a popular Divi replacement for users who want better performance without a steep learning curve.
**Handles:**
- et_pb_section → Breakdance Section element
- et_pb_row/et_pb_column → Breakdance Div elements with flex layout
- et_pb_text → Breakdance Text element
- et_pb_blurb → Breakdance Icon Box or container with children
> Ready to migrate? Your original Divi pages remain completely untouched.
> 1. Migrate all pages
> 2. Migrate specific pages
> 3. Start with a test page (recommended)
> 4. Just keep this plan
### Phase 3: Page-by-Page Migration
For each approved page:
1. Read Divi content via `respira_extract_builder_content` with `builder=divi`
2. Parse the shortcode tree:
- Build section → row → column → module hierarchy
- Decode encoded content
- Resolve global module references
- Calculate column widths from type attributes
3. Generate Breakdance element structure:
- `et_pb_section` → Breakdance Section
- `et_pb_row` + `et_pb_column` → Breakdance Div elements with flex layout and percentage widths
- Map each module to Breakdance element:
- `et_pb_text` → Text element (preserve HTML content)
- `et_pb_blurb` → Icon Box element (map icon, title, body)
- `et_pb_image` → Image element (map src, alt)
- `et_pb_button` → Button element (map text, URL, style)
- `et_pb_accordion` → Accordion element (map items)
- `et_pb_tabs` → Tabs element (map tab titles and content)
- Map colors, spacing, typography to Breakdance settings
- Flag unmappable modules
4. Take a `respira_get_snapshot` checkpoint of the target before any write, so the page can be restored exactly if the conversion needs unwinding
5. Create duplicate via `respira_create_page_duplicate` or `respira_create_post_duplicate`
6. Write Breakdance content to the duplicate via `respira_inject_builder_content` with `builder=breakdance`
7. Surgical fixes (not a re-inject): when a single element lands wrong — a heading, a button label, a spacing value — locate it with `respira_find_element` and correct it in place with `respira_update_element`. For repeated corrections across many elements or several migrated pages, batch them with `respira_batch_update` rather than re-injecting whole pages.
8. Report status
### Phase 4: Post-Migration Verification
1. Summarize migrations:
- Pages migrated, elements created, items flagged
2. For each migrated page:
- Link to Breakdance editor
- Flagged items list
- Layout and encoding notes
3. Post-migration checklist:
- [ ] Open each duplicate in Breakdance editor
- [ ] Verify section and layout structure
- [ ] Check responsive views
- [ ] Verify images and media
- [ ] Test links and buttons
- [ ] Recreate flagged modules
- [ ] Rebuild forms with Breakdance form element
- [ ] Set up global templates (header/footer) in Breakdance
- [ ] Review Breakdance's clean CSS output
- [ ] Compare with Divi original
- [ ] Check for Divi shortcode remnants
## Safety Model
- Read-only analysis first — full content scan before any changes
- Explicit user confirmation required before creating duplicates
- Original Divi pages are never modified or deleted
- All migrated content goes to draft duplicates only
- Never auto-publishes migrated pages
- Takes a `respira_get_snapshot` checkpoint before each write
- Explicit rollback: restore the snapshot via `respira_restore_snapshot`, or delete the draft duplicates if they are not wanted
- Warns about theme implications if using Divi theme
## Honest Disclaimer
This skill converts Divi page content to Breakdance format and creates draft duplicates for review.
It cannot:
- Migrate specialty section layouts perfectly
- Convert global modules to Breakdance global blocks automatically
- Handle third-party Divi plugin modules
- Transfer Divi theme customizer settings
- Migrate popups, dynamic content, or animations
- Guarantee pixel-perfect visual fidelity from shortcodes
It can:
- Parse Divi's complex shortcode hierarchies including encoded content
- Convert 80-90% of standard Divi modules to Breakdance elements
- Produce cleaner CSS and HTML output than Divi
- Preserve all text, images, links, and core styling
- Save significant manual rebuilding time
- Clearly flag everything needing manual work
- Keep original pages completely safe
## Tooling
**Core WordPress tools**
- `respira_get_site_context`
- `respira_list_plugins`
- `respira_list_pages`
- `respira_list_posts`
- `respira_read_page`
- `respira_read_post`
- `respira_get_builder_info`
- `respira_extract_builder_content`
- `respira_inject_builder_content`
- `respira_find_builder_targets`
- `respira_create_page_duplicate`
- `respira_create_post_duplicate`
- `respira_get_snapshot`
- `respira_restore_snapshot`
- `respira_find_element`
- `respira_update_element`
- `respira_batch_update`
## Telemetry
After run completion, send fire-and-forget usage tracking to:
