migrate

Renders inventoried pages into a self-contained deployable static HTML site.

1|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aemgdc/aemdev --skill migrate-aemgdc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: migrate
Source: https://github.com/aemgdc/aemdev/tree/main/.agents/skills/migrate
Command: npx skills add https://github.com/aemgdc/aemdev --skill migrate-aemgdc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Redesigning a website page-by-page by hand is slow and error-prone. This Skill applies a target design system, visual canon, and module catalog to every page in a migration inventory, producing a self-contained static HTML bundle that can be zipped and deployed to any static host. ## Core Features & Use Cases - Three render branches: approved pages render verbatim from prototypes, sibling pages inherit approved template archetypes with slot injection, and unique pages render one-off from design tokens and canon. - Idempotent and incremental migration: sha-based skip logic re-renders only changed pages, so large sites migrate incrementally without redundant work. - Self-contained asset bundling: every referenced image, font, and favicon is copied into the output tree and all references rewritten to depth-aware relative paths that work on file://, host root, or any subpath. - Use Case: After extracting and prototyping a 127-page nonprofit site, run the migration to emit 122 static HTML pages with bundled assets, sitemap.xml, robots.txt, and per-page _meta.json provenance sidecars ready for zip-and-deploy. ## Quick Start Run the migrate skill to render every directed page in the stardust inventory into the deployable static site under stardust/migrated/.

Frequently Asked Questions about migrate

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

FAQPage Schema
How do I migrate a website to a new design as static HTML?▼

Run the migrate skill after extraction, direction, and prototyping are complete. It renders each inventoried page through one of three branches (approved prototype, template-applied sibling, or unique render) and writes a self-contained static HTML bundle under stardust/migrated/.

How does incremental static site migration avoid re-rendering unchanged pages?▼

Each page is sha-compared across DESIGN.md, DESIGN.json, source content, proposed files, canon files, and archetype sources. Pages whose hashes all match are skipped and reported as unchanged; only edited inputs trigger re-renders.

Can the migrated static site be deployed to any host or opened via file://?▼

Yes. All internal references are rewritten to depth-aware relative paths with explicit index.html targets, so the bundle works on file://, at a webserver root, or at any subpath. Phase 3 portability audits verify this with grep checks and a headless file:// round-trip.

What happens when a page contains placeholder or unsourced content during migration?▼

Migration refuses the page. The placeholder gate blocks any page with data-placeholder elements or non-empty unsourced content lists, and there is no bypass flag. The user must source the real content and re-invoke migrate.

Does the migration output AEM EDS markup or CMS components?▼

No. The output is platform-agnostic static HTML only. Downstream conversion to AEM EDS, a CMS payload, or framework components is the job of a separate plugin that consumes the migrated tree plus DESIGN.json and the per-page _meta.json sidecars.

Why does migrate fail with a provenance validation error?▼

Every in-scope page must carry live-render evidence in its state record. Pages synthesized without real extraction fail validateProvenance and abort the run, because migrating them would produce HTML that misrepresents the source site.