wp-migrate

Migrate WordPress, SPA, and website builder content to static site generators with diagnostic checks.

Updated Apr 1, 2018
One-click install
npx skills add https://github.com/reset/dotfiles --skill wp-migrate-reset
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-migrate
Source: https://github.com/reset/dotfiles/tree/main/.claude/skills/wp-migrate
Command: npx skills add https://github.com/reset/dotfiles --skill wp-migrate-reset

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Migrating content from WordPress, SPAs, or website builders to static generators is rife with hidden pitfalls: critical content often lives in serialized ACF fields or JS data blobs instead of standard XML exports, design CSS is split across dynamically imported bundles, and interactive UI elements are gated by JavaScript you didn't plan to port, leading to broken ports and weeks of rework.

Core Features & Use Cases

  • Diagnostic-first approach: Guides you to locate hidden content sources, design systems, and interactive elements before starting extraction, avoiding costly late-stage fixes.
  • Multi-platform support: Covers WordPress (with ACF Pro, Gutenberg, page builders), Nuxt/Vue/React SPAs, Webflow/Squarespace/Wix, and legacy PHP/Rails sites.
  • Reproducible workflow: Provides a standard project structure and Makefile template to make every step of fetching, extracting, and building reproducible and easy to debug.
  • Use case example: For a WordPress site with ACF flexible content and a Nuxt frontend, the skill guides you to pull structured content from the WP REST API instead of the incomplete XML export, concatenate CSS bundles, and fix JS-gated reveal animations to match the live site.

Quick Start

Use this skill to migrate your WordPress site with ACF Pro and a Nuxt frontend to a static generator like Zola by following the guided diagnostic and extraction workflow.

Frequently Asked Questions about wp-migrate

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

FAQPage Schema
How do I migrate WordPress content with ACF Pro to a static site generator without losing data?

To migrate WordPress content with ACF Pro to a static site generator, pull structured content from the WP REST API instead of incomplete XML exports. This ensures serialized ACF flexible content fields are fully extracted before the static build.

Why does my static site migration break dynamically imported CSS bundles from Nuxt?

Static site migrations break Nuxt CSS because design styles are often split across dynamically imported bundles. You need to concatenate these CSS bundles during the extraction phase to preserve the original design fidelity in the static output.

What's the best way to locate hidden content sources before migrating a website to static HTML?

The best way to locate hidden content sources before static migration is using a diagnostic-first approach. Run guided checks to find JS data blobs, design assets, and interactive elements before extraction to prevent costly late-stage rework.

Can I migrate a Webflow or legacy PHP site to a static generator using a reproducible workflow?

Yes, you can migrate Webflow, Squarespace, and legacy PHP sites to static generators using a reproducible workflow. A standard project structure and Makefile template make fetching, extracting, and building steps easy to debug.

How do I fix JS-gated UI states like reveal animations when porting a site to a static generator?

To fix JS-gated UI states like reveal animations during static migration, identify and port interactive JavaScript elements during the diagnostic phase. This ensures the static site matches the live site's dynamic interactive behavior.

Does this static site migration approach work with Nuxt, Vue, and React frontends?

Yes, this static site migration approach works with Nuxt, Vue, and React single-page applications. It handles extraction from JS data blobs and concatenates split CSS bundles to maintain design fidelity in static generators.