Migrate Squarespace

A skill for migrating most Squarespace sites to a static site the owner controls — restaurant, photographer, blog, brochure, portfolio. It's a method, not a template: it discovers the source site's actual structure and design, rebuilds it in a framework you choose, and judges the result against the original. It creates a simple .md file configuration for page editing instead of Squarespace's visual editor. If you're using a coding agent (like Claude Code) this makes it very easy and accessible to work through page edits/new pages direclty with Claude after you've migrated your site.

The skill lives in skill/migrate-squarespace/. Start with its SKILL.md (the six-phase playbook). Supporting material, all paths relative to that folder:

• reference/squarespace-findings.md — how Squarespace serves assets, HLS video, ?format=json collections, focal points, Typekit fonts, viewport-relative layout.
• reference/method-and-guards.md — the method's principles and the failure-mode guards ("the rendered pixel is the arbiter"; replicate vs. normalize; infer the site's shape).
• reference/build-patterns.md — framework-agnostic build patterns, with a "choose your framework" comparison and patterns for focal points, images, forms, content protection, redirects, and fonts.
• reference/fidelity-rubric.md — a design-neutral LLM-as-judge rubric that scores how closely the rebuild matches the source, run as the verification step.
• scripts/ — generic, config-driven tools (discover, extract, extract-videos, collect-posts, sample-styles, optimize-images, verify, capture-pairs) that read one migration.config.json and assume nothing about the site's shape or the target framework.

Scope: content/marketing sites. Not e-commerce checkout (needs a commerce backend).

Install

As a Claude Code plugin (recommended)

Inside Claude Code, add this repo as a plugin marketplace and install it — no cloning, no symlinks:

/plugin marketplace add github:aml25/migrate-squarespace-skill
/plugin install migrate-squarespace@migrate-squarespace-skill

Pull updates later with /plugin marketplace update migrate-squarespace-skill.

Manual — symlink into a skills directory

Prefer not to use the plugin? This also covers OpenAI Codex CLI, which supports the same skill format and auto-discovers skills the same way — only the target directory differs. Clone once, then symlink the skill into your agent's skills directory:

git clone https://github.com/aml25/migrate-squarespace-skill.git
SKILL="$(pwd)/migrate-squarespace-skill/skill/migrate-squarespace"

# Claude Code
mkdir -p ~/.claude/skills && ln -s "$SKILL" ~/.claude/skills/migrate-squarespace

# OpenAI Codex CLI
mkdir -p ~/.agents/skills && ln -s "$SKILL" ~/.agents/skills/migrate-squarespace

Both auto-discover the skill from its SKILL.md description — nothing else to run.

Tool dependencies (either method)

The scripts/ tools need Node 18+ and a one-time install — a headless Chromium (via Playwright), plus ffmpeg-static and sharp. Your agent runs this the first time it needs the tools, or you can do it yourself from the skill's scripts/ directory:

npm install && npm run install-browser

Usage

You don't run a command — describe the task and the agent invokes the skill automatically (it's triggered by the skill's description). For example:

Migrate my Squarespace site at example.com to a static site.

Claude then walks the six phases — Discover → Decide → Harvest → Build → Verify → Report — pausing at confirmation gates along the way. It will:

• ask for your live Squarespace URL and help you choose a target framework;
• discover your real pages, extract content + images + video, and rebuild the design measured from your live site;
• flag anything it can't migrate (e-commerce, memberships, scheduling, form/newsletter integrations, …) and propose replacements;
• judge the rebuild against the original with the fidelity rubric, and hand off a site you edit as plain .md files.

You can also trigger it explicitly from Claude Code's slash menu (plugin skills appear under the migrate-squarespace namespace). The scripts/ tools are plain Node too, and can be run directly (node discover.mjs …) — see SKILL.md for the per-phase commands.

Using with other agents

The skill is just a SKILL.md playbook, plain-Node scripts/, and reference/ docs — nothing Claude-specific — so any coding agent that reads instructions and runs a shell can use it.

• OpenAI Codex CLI auto-discovers the skill from its description — install it via the Manual — symlink into a skills directory step above (Codex reads ~/.agents/skills/).
• Cursor has no skills-directory auto-discovery, but reads the cross-tool AGENTS.md standard and .cursor/rules/*.mdc. Clone the repo, then point Cursor's agent at the playbook — an AGENTS.md line ("For Squarespace migrations, follow …/skill/migrate-squarespace/SKILL.md") or a .cursor/rules/migrate-squarespace.mdc that references it.
• Anything else (Aider, Windsurf, Gemini CLI, …) — point it at SKILL.md and run the scripts directly (node discover.mjs …).

After the one-line pointer, the six-phase method and the tools are identical everywhere.

License

Apache License 2.0. Copyright 2026 Adam Laskowitz.