PluginPartly tested (needs an account)
Move a WordPress site to a static site
astro-conversion-kit
Free skills that turn your WordPress site into a static Astro site with the same URLs, SEO tags, media and redirects, checked page by page before launch.
- Works with
- Claude Code, Codex CLI
- Good for
- Web developers, Build an app
What it does
This kit helps you leave WordPress without losing your search rankings. Your assistant reads your live site, copies every public page, image and redirect, and rebuilds it as a static site with Astro. A static site is plain files, so there is no database or plugin to update.
It is a set of eight skills. convert-site runs the others in order: capture the site, plan, build, check, compare screenshots, and launch checks. Before anything goes live, it checks that every old address still works and that page titles, descriptions and structured data match the old site. It compares screenshots of the old and new pages at phone, tablet and desktop widths until they match.
The work ends with a pull request, a hidden test version of the site and a launch checklist. You decide when to switch over. It does not log in to your old site and does not change your domain settings.
Other sites served over the web (Drupal, Webflow, Squarespace, Wix, plain HTML) work too. Shops on Shopify are out of scope.
Example prompts
- "Convert https://your-site.example to Astro."
- "defaults" (as the answer to its one message of questions)
- "Show me the list of things a static site cannot do for my site."
- "Run the launch audit against the staging site."
How to install
/plugin marketplace add ethanplusai/astro-conversion-kit/plugin install astro-conversion@astro-conversion-kitHow to use it
After installing, ask: "Convert https://your-site.example to Astro" with the address of your own site, then answer its one message of questions (or reply "defaults").
Check it works
Run /plugin in Claude Code and check that astro-conversion is listed. Then ask it to convert your own site. Before its one question message, it runs a preflight check that lists the tools the run needs (Node, git, gh, the hosting CLI, the Playwright browser) and whether each is installed and logged in.
Common problems
- The run refuses to start — it needs Node 22.23.4 or newer on the 22 line, or 24.22.1 or newer; Node 20 is refused — https://github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/README.md
- No pull request is created —
ghis not logged in; rungh auth login, or push and open the PR yourself from the runbook — https://github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/skills/convert-site/SKILL.md - Search, comments or a shop stop working — a static site cannot run them; the kit lists them at the start with options — https://github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/README.md
- It does not work on Windows — this version supports macOS and Linux only — https://github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/README.md
Other assistants
- Codex: the README names Codex but gives no Codex command; its route for "any agent that reads Agent Skills" is
npx skills add ethanplusai/astro-conversion-kit. That is the only route for Codex. AGENTS.md says to install all eight skills together — https://github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/AGENTS.md - Gemini CLI: not named in the repo, and not in the Gemini extensions gallery
What to watch out for
- The README's main route is a text to paste to your assistant: `Convert https://example.com to Astro with https://github.com/ethanplusai/astro-conversion-kit`. The assistant then reads the repo from that link and installs the skills itself. Use the two exact commands above instead
- Crawls every public page of the site you name: sitemaps, the WordPress REST API and links, paced at 400 ms between requests with up to 4 at a time, plus screenshots in a headless Chromium. It also asks web.archive.org (the Wayback Machine) for old addresses (--no-wayback turns that off). It works on any public site, so use it only on your own site
- Installs software without asking. If the kit has no node_modules folder (true for a fresh plugin or npx skills install), convert-site clones the repo again and runs npm install (css-tree, parse5, pixelmatch, playwright, pngjs). It also runs npx playwright install chromium and runs the vercel and wrangler CLIs through npx
- After the one intake message it runs to the end without stopping: shell commands, Node scripts and a browser on your computer, a new GitHub repo, commits, a push and a pull request with your gh login, and a staging deploy with your Vercel or Cloudflare login. The staging address is public but marked noindex. Large media can go to Vercel Blob or Cloudflare R2
- Forms are rewired to a third-party form service (Formspree by default), and the run sends one test submission to the address you give at intake. It never submits forms or logs in on the old site, and never changes DNS
- Needs Node 22.23.4 or newer on the 22 line, or 24.22.1 or newer (Node 20 is refused), git and Playwright's Chromium. macOS or Linux only; Windows is not supported in this version
- The README's results (average run time, design checks passed and PageSpeed scores over 45 sites) are the author's own figures, not checked here
Licence and author
- Licence
- MIT
- Author
- Ethan Rogers (ethanplusai)
- Source code
- github.com/ethanplusai/astro-conversion-kit
How we tested it
We installed it on an empty test computer on 3 Nov 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.
Technical details of the test
- Date
- 3 Nov 2026
- Method
- Reviewed by our team against the repository, its README and docs.
Checked again on 3 Nov 2026
Alternatives
- Build with WordPress — stay on WordPress and build or improve the site there instead
- Chrome DevTools MCP — measures page speed without moving the site
- Web Quality Skills — audits speed, accessibility and SEO of the site you have now
FAQ
- Q: Do I need my WordPress password? A: No. It only reads what the site shows the public.
- Q: Will my Google rankings drop? A: It keeps the same URLs, titles and redirects to avoid that, but no tool can promise rankings.
- Q: Can I use it on someone else's site? A: No. Use it only on your own site.
- Q: Does it cost money? A: The kit is free under MIT. Hosting on Vercel or Cloudflare and a form service can have their own costs.
Sources
- github.com/ethanplusai/astro-conversion-kit
- github.com/ethanplusai/astro-conversion-kit/tree/8beb1de5099a2be1ddb1d98ffc7b3682343bc420
- github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/README.md
- github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/AGENTS.md
- github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/.claude-plugin/marketplace.json
- github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/skills/convert-site/SKILL.md
- github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/skills/capture-site/SKILL.md
- github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/docs/platforms.md
- github.com/ethanplusai/astro-conversion-kit/blob/8beb1de5099a2be1ddb1d98ffc7b3682343bc420/package.json