Page Import Orchestrator

You are an orchestrator of a website page import/migration. You have specialized Skills at your disposal for each phase of the import workflow. Below is a high-level overview of what you're going to do.

When to Use This Skill

Use this skill when:

• Importing or migrating individual pages from existing websites

• Converting competitor pages for reference or analysis

• Creating content files from design prototypes or staging sites

Do NOT use this skill for:

• Building new blocks from scratch (use content-driven-development skill)

• Modifying existing block code (use building-blocks skill)

• Designing content models (use content-modeling skill)

Scope

This skill imports/migrates main content only:

• ✅ Import: Hero sections, features, testimonials, CTAs, body content

• ❌ Skip: Header, navigation, footer (handled by dedicated skills)

Philosophy

Follow David's Model (https://www.aem.live/docs/davidsmodel):

• Prioritize authoring experience over developer convenience

• Ask "How would an author in Word/Google Docs create this?"

• Minimize blocks - prefer default content where possible

• Use Block Collection content models

Available Sub-Skills

This orchestrator delegates work to:

• scrape-webpage - Extract content, metadata, and images from source URL

• identify-page-structure - Identify section boundaries and content sequences

• authoring-analysis - Make authoring decisions (default content vs blocks)

• generate-import-html - Create structured HTML file

• preview-import - Verify in local dev server

These skills invoke additional skills as needed:

• page-decomposition - (via identify-page-structure) Analyze content sequences per section

• block-inventory - (via identify-page-structure) Survey available blocks

• content-modeling - (via authoring-analysis) Validate unclear block selections

• block-collection-and-party - (via authoring-analysis) Validate block existence

Import Workflow

Step 0: Create TodoList

Use the TodoWrite tool to create a todo list with the following tasks:

Scrape the webpage (scrape-webpage skill)

• Success: metadata.json, screenshot.png, cleaned.html, images/ folder exist

Identify page structure (identify-page-structure skill)

• Success: Section boundaries identified, content sequences documented, block inventory complete

Analyze authoring approach (authoring-analysis skill)

• Success: Every content sequence has decision (default content OR block name), section styling validated

Generate HTML file (generate-import-html skill)

• Success: HTML file exists, images folder copied, validation checklist passed

Preview and verify (preview-import skill)

• Success: Page renders correctly in browser, matches original structure

Step 1: Scrape Webpage

Invoke: scrape-webpage skill

Provide:

• Target URL

• Output directory: ./import-work

Success criteria:

• ✅ metadata.json exists with paths, metadata, image mapping

• ✅ screenshot.png saved for visual reference

• ✅ cleaned.html with local image paths

• ✅ images/ folder with all downloaded images

Mark todo complete when: All files verified to exist

Step 2: Identify Page Structure

Invoke: identify-page-structure skill

Provide:

• screenshot.png from Step 1

• cleaned.html from Step 1

• metadata.json from Step 1

Success criteria:

• ✅ Section boundaries identified with styling notes

• ✅ Content sequences documented for each section (neutral descriptions)

• ✅ Block inventory completed (local + Block Collection)

Mark todo complete when: All outputs documented

Step 3: Analyze Authoring Approach

Invoke: authoring-analysis skill

Provide:

• Section list with content sequences from Step 2

• Block inventory from Step 2

• screenshot.png from Step 1

Success criteria:

• ✅ Every content sequence has decision: default content OR block name

• ✅ Block structures fetched for all blocks to be used

• ✅ Single-block sections validated for styling (Step 3e if applicable)

Mark todo complete when: All sequences have authoring decisions

Step 4: Generate HTML File

Invoke: generate-import-html skill

Provide:

• Authoring analysis from Step 3

• Section styling decisions from Step 3

• metadata.json from Step 1

• cleaned.html from Step 1

Success criteria:

• ✅ HTML file saved at correct path (from metadata.json)

• ✅ All sections imported (no truncation)

• ✅ Images folder copied to correct location

• ✅ Metadata block included (unless skipped)

• ✅ Validation checklist passed

Mark todo complete when: HTML file written, images copied, validation passed

Step 5: Preview and Verify

Invoke: preview-import skill

Provide:

• HTML file path from Step 4

• screenshot.png from Step 1 (for comparison)

• documentPath from metadata.json

Success criteria:

• ✅ Page loads in browser

• ✅ Blocks render correctly

• ✅ Layout matches original (compare with screenshot)

• ✅ No console errors

• ✅ Images load or show placeholders

Mark todo complete when: Visual verification passed

High-Level Dos and Don'ts

DO:

• ✅ Follow the workflow steps in order

• ✅ Mark each todo complete after verification

• ✅ Use TodoWrite to track progress

• ✅ Import ALL content (partial import is failure)

• ✅ Compare final preview with original screenshot

DON'T:

• ❌ Skip steps or combine steps

• ❌ Make authoring decisions without block inventory

• ❌ Generate HTML before completing authoring analysis

• ❌ Truncate or summarize content

• ❌ Consider import complete without visual verification

Success Criteria

Import is complete when:

• ✅ All 5 todos marked complete

• ✅ HTML file renders in browser

• ✅ Visual structure matches original page

• ✅ All content imported (no truncation)

• ✅ Images accessible

Limitations

This orchestrator manages single-page import with existing blocks. It does NOT:

• Custom variant creation (blocks are used as-is)

• Multi-page batch processing (import one page at a time)

• Block code development (assumes blocks exist)

• Advanced reuse detection across imports

• Automatic block matching algorithms

For those features, consider more comprehensive import workflows in specialized tools.