Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
adobe avatar

Preview Import

  • 31 installs
  • 45 repo stars
  • Updated August 4, 2026
  • adobe/helix-website

preview-import is a Claude Code skill that previews content imported into a local AEM Edge Delivery Services dev server and verifies it renders like the original page.

About

preview-import opens imported content in a local AEM Edge Delivery Services development server and verifies it renders correctly. A developer runs it after generating import HTML to check block styling, image loading, and metadata against the original page screenshot. It is the final verification step of Adobe's page-import workflow.

  • Previews imported HTML in a local AEM Edge Delivery Services dev server (aem up on localhost:3000)
  • Compares the rendered page against the original screenshot to verify block decoration and layout
  • Ships a troubleshooting guide for broken blocks, missing images, raw HTML, and 404s

Preview Import by the numbers

  • 31 all-time installs (skills.sh)
  • Ranked #1,450 of 2,245 Frontend Development skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

preview-import capabilities & compatibility

Capabilities
content migration · block preview · local dev server
Use cases
web design · frontend
From the docs

What preview-import says it does

Open and verify imported content in local development server.
SKILL.md
This starts the local AEM proxy server at `http://localhost:3000`
SKILL.md
Layout matches original page structure (compare to screenshot.png)
SKILL.md
npx skills add https://github.com/adobe/helix-website --skill preview-import

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs31
repo stars45
Last updatedAugust 4, 2026
Repositoryadobe/helix-website

What it does

Preview and verify content imported into a local AEM Edge Delivery Services dev server before opening a pull request.

Who is it for?

AEM Edge Delivery developers verifying that imported pages render correctly before a PR

Skip if: Scraping source pages (use scrape-webpage) or general web frameworks outside AEM Edge Delivery

When should I use this skill?

You have generated import HTML and need to preview and verify it in the local AEM dev server

What you get

A verified local preview whose blocks, images, and metadata match the original page

  • Verified local preview matching the original page structure
  • Validated block decoration and metadata presence

By the numbers

  • 4-step preview workflow (start server, navigate, verify rendering, compare)
  • 6-point rendering verification checklist

Files

SKILL.mdMarkdownGitHub ↗

Preview Import

Open and verify imported content in local development server.

When to Use This Skill

Use this skill when:

  • You have generated HTML file (from generate-import-html)
  • Ready to preview in browser and verify rendering
  • Need to compare with original page structure

Invoked by: page-import skill (Step 5)

Prerequisites

From previous skills, you need:

  • ✅ HTML file at correct path (from generate-import-html)
  • ✅ Images folder in same directory
  • ✅ screenshot.png from scrape-webpage (for comparison)
  • ✅ documentPath from metadata.json (for URL construction)

Related Skills

  • page-import - Orchestrator that invokes this skill
  • generate-import-html - Provides HTML file to preview
  • scrape-webpage - Provides screenshot for comparison

Preview Workflow

Step 1: Start Development Server

Command:

aem up

This starts the local AEM proxy server at http://localhost:3000

---

Step 2: Navigate in Browser

For most files, use the document path directly:

http://localhost:3000${documentPath}

Example:

  • HTML file: us/en/about.plain.html
  • URL: http://localhost:3000/us/en/about

IMPORTANT: For index files, use `/index` instead of `/`:

If file is: index.plain.html
Preview at: http://localhost:3000/index
NOT: http://localhost:3000/

Note: If you used --html-folder flag (e.g., aem up --html-folder drafts), prepend that folder to the URL:

File: drafts/test.plain.html
URL: http://localhost:3000/drafts/test

Use paths.documentPath from metadata.json, but for index files ensure the path is /index not /

---

Step 3: Verify Rendering

Check the following:

  • ✅ Blocks render with correct styling
  • ✅ Layout matches original page structure (compare to screenshot.png)
  • ✅ Images load (or show appropriate placeholders)
  • ✅ No raw HTML visible
  • ✅ Metadata appears in page source (view source, check <meta> tags)
  • ✅ Section styling applied correctly

---

Step 4: Compare with Original

Side-by-side comparison: 1. Open ./import-work/screenshot.png alongside browser preview 2. Check that content structure matches 3. Verify blocks decorated correctly 4. Confirm section boundaries align 5. Validate styling consistency

---

Troubleshooting

Blocks don't render correctly:

  • Check HTML structure matches expected format
  • Verify block names match exactly (case-sensitive)
  • Review ../page-import/resources/html-structure.md for format guidance

Images not loading:

  • Verify images folder is in same directory as HTML file
  • Check image paths are ./images/... format
  • Ensure images were copied correctly from ./import-work/images/

Raw HTML visible:

  • Block name might not match existing block in project
  • Check browser console for JavaScript errors
  • Verify block exists in blocks/ directory

Metadata not in page source:

  • Check metadata block is at end of HTML file
  • View page source and search for <meta> tags in <head>
  • Verify metadata properties match expected format

Dev server not running:

  • Start server with aem up
  • Check for port conflicts (default 3000)
  • Verify you're in correct project directory

Page not found (404):

  • Verify HTML file exists at expected path
  • Check documentPath from metadata.json matches URL
  • For index files, use /index not /
  • If using --html-folder, include folder in URL

---

Output

This skill provides:

  • ✅ Verified preview that matches original page structure
  • ✅ Visual confirmation of correct rendering
  • ✅ Validated block decoration
  • ✅ Confirmed metadata presence

Import complete when all verification points pass.

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.