К основному содержанию
плагин

astro-conversion — плагин для Claude Code: перенос в Astro

Плагин astro-conversion для Claude Code переносит WordPress или другой сайт, доступный по HTTP, в статический Astro. Он собирает сайт и проверяет маршруты, SEO-данные и визуальное сходство.

MIT ★ 137 обновлён 2026-10-31

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add ethanplusai/astro-conversion-kit
/plugin install astro-conversion@astro-conversion-kit
Открыть на GitHub

Что делает astro-conversion

astro-conversion переносит содержимое сайта в новый проект Astro и открывает pull request с результатом. Сначала плагин обходит страницы и сохраняет HTML, метаданные, перенаправления, медиафайлы и снимки экрана в capture/, затем создаёт план и собирает сайт на ветке astro-rebuild.

Проверки сравнивают новый сайт с сохранённой копией: сверяют маршруты, тексты, ссылки, SEO-теги, медиа и формы. Визуальный этап сравнивает снимки страниц с помощью попиксельного анализа; в описанном процессе используются ширины 390, 768 и 1440 px. Для запуска нужны Node, git, gh, CLI выбранного хостинга и браузер Playwright; preflight.mjs проверяет инструменты и авторизацию. Формы отправляются на сторонний адрес, указанный при сборе требований.

Какие задачи решает

  • перенести страницы WordPress в статический проект Astro
  • сохранить адреса страниц и перенаправления
  • сверить метаданные и содержимое нового сайта с исходным
  • найти визуальные расхождения между исходной и новой страницами

Примеры запросов агенту

  • Перенеси мой сайт WordPress в статический проект Astro и подготовь pull request.
  • Собери сайт, доступный по HTTP, в Astro и сравни его страницы с исходными.
  • Проверь новый сайт по сохранённой копии: маршруты, SEO-теги и снимки страниц.

Как установить astro-conversion

Через маркетплейс плагинов

/plugin marketplace add ethanplusai/astro-conversion-kit
/plugin install astro-conversion@astro-conversion-kit

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы об astro-conversion

Как установить astro-conversion в Claude Code?

Выполни /plugin marketplace add ethanplusai/astro-conversion-kit и затем /plugin install astro-conversion@astro-conversion-kit.

Что делает astro-conversion?

Плагин переносит сайт в Astro, проверяет результат по сохранённой копии и создаёт pull request. Для WordPress он собирает страницы, метаданные, перенаправления и медиафайлы.

Что нужно для работы astro-conversion?

Для запуска нужны Node, git, gh, CLI выбранного хостинга и браузер Playwright. Формы отправляются на сторонний адрес, который задают при сборе требований.

Исходный текст

SKILL.md · MIT
# astro-conversion-kit

Convert a WordPress site to static Astro with your coding agent, and get back the same site: the
same URLs, the same content, the same titles, descriptions, canonicals and structured data, the
same media at the same paths, every redirect the old site performs, and a design checked pixel by
pixel at 390, 768 and 1440 px. No PHP, no plugins, no database, no server to patch.

It is a set of Agent Skills, so it runs in Claude Code, Codex or any agent that reads `SKILL.md`.
Plain Node scripts do everything that has to be exact, and gates prove each part before the work
moves on. A run ends with a pull request, a noindexed staging deploy and a launch runbook.

WordPress is the first-class case. Anything served over HTTP works, because the capture reads the
rendered HTML; see [docs/platforms.md](docs/platforms.md).

## Start

Paste this into your coding agent, with your site in place of example.com:

```
Convert https://example.com to Astro with https://github.com/ethanplusai/astro-conversion-kit
```

That is the whole job. The agent installs the skills, asks you one message of questions (each
with a stated default: where the repo goes, which host, how forms are handled), and runs to a pull
request without stopping again. Answer "defaults" and it picks every default.

To install the skills first, into any agent that reads Agent Skills:

```
npx skills add ethanplusai/astro-conversion-kit
```

In Claude Code, from its plugin marketplace:

```
/plugin marketplace add ethanplusai/astro-conversion-kit
/plugin install astro-conversion@astro-conversion-kit
```

Or from a clone, which also lets you run any script by hand:

```
git clone https://github.com/ethanplusai/astro-conversion-kit
cd astro-conversion-kit
npm install
npx playwright install chromium
node skills/convert-site/scripts/preflight.mjs
```

`preflight.mjs` says which tools the run needs (Node, git, gh, the hosting CLI, the Playwright
browser) and whether each is installed and logged in. Every script prints `--help`.

## Results

![45 WordPress sites converted to static Astro: average run time 83 minutes, design parity passed on 45 of 45, Google PageSpeed performance 74 to 98 on mobile and 87 to 99 on desktop](docs/examples/results.png)

Averages over 45 WordPress conversions run with the kit, intake to pull request. Every run passed
the pixel-parity review at all three widths.

### Demos

Public WordPress sites converted by a coding agent following the skills as published. Each link
is the Astro build on Vercel; each image is the live WordPress page beside the Astro build.
Counts and timings are in [docs/examples](docs/examples/README.md).

**sxsw.com** (WordPress VIP, block theme, 71 pages): https://sxsw-com-astro-v2.vercel.app

![sxsw.com home page hero, before on WordPress and after on Astro, with the hero video playing on both](docs/examples/sxsw-home.gif)

**harvard.edu** (WordPress multisite, 457 pages): https://harvard-edu-astro.vercel.app

![harvard.edu /ai/ page, before on WordPress and after on Astro](docs/examples/harvard-ai-1440.png)

**angrybirds.com** (WordPress on WP Engine, 388 pages, media in Vercel Blob): https://angrybirds-com.vercel.app

![angrybirds.com home page, before on WordPress and after on Astro](docs/examples/angrybirds-home-1440.png)

## What happens

1. **Intake.** At most four requests fingerprint the platform; one message asks you where the
   repo and hosting go, how forms are handled, and what the agent cannot detect.
2. **Capture.** A paced, read-only crawl (sitemaps, the WordPress REST API, links) saves every
   page's HTML, head tags, redirects, media list, fonts, feeds and screenshots into `capture/`.
3. **Plan.** `docs/plan.md`: templates, counts, the media decision, and a row for every oddity.
4. **Scaffold and baseline.** A new Astro repo on an `astro-rebuild` branch, with the capture
   frozen into `baseline/` so the gates never need the old site again.
5. **Build.** Layouts first, then pages from the captured markup, the captured CSS pruned by
   coverage, media at the original paths, forms and third-party scripts carried over by list.
6. **Gates.** Routes, redirects, SEO tags, visible text, links, media, sitemap, feeds, forms and
   scripts, checked against the baseline on every commit.
7. **Visual review.** Live and new screenshots per template at three widths, pixel-diffed, plus a
   computed-style check, until every pair passes; then every page at 390 and 1440.
8. **Launch checks.** `pre-launch` on the repo, a staging deploy, `launch-audit` against staging,
   a suggestions report, and the PR. You merge and launch; `post-launch` watches the first 30 days.

[docs/process.md](docs/process.md) says what each phase produces and what proves it done.

## What you get

- A pull request from `astro-rebuild` to `main` in a repo you own, with the gate output, counts,
  every exception and proposal, and the launch skills' "Not covered" sections quoted in full.
- A noindexed staging deploy on Vercel or Cloudflare Pages (or a local preview and a first
  runbook step to deploy, if you have no hosting account yet).
- Contact sheets: live, new and diff screenshots side by side for every template and width.
- `docs/suggestions.md`: broken links, missing alt text, duplicate titles, slow images and other
  improvements the agent found but did not make, each with evidence, effort and risk.
- `docs/LAUNCH.md`: the runbook, in order, with the exact commands for your host.
- `npm run verify` in the new repo, so the gates keep working after the old site is gone.

The default build reproduces the live site, faults included. Fixes are proposals you approve.

## WordPress, specifically

The capture needs no admin login, plugin or database export; it reads what the site serves.

- **Every public page and post**, from the sitemaps, the REST API (`wp/v2/pages`, `posts`,
  `media`, `categories`, `tags`) and the links between pages, so nothing the sitemap forgot is
  missed. Drafts and private content never appear; the API only returns what is public.
- **Every image size.** The resized copies WordPress writes (`photo-300x200.jpg`, ...) and lists
  in `srcset` all stay at their paths, because other sites and old emails may link to any of them.
- **Media that fits the repo stays in it**; larger libraries go to Vercel Blob or Cloudflare R2
  at the same URLs, with the decision made per site and written into the plan.
- **`?p=` shortlinks, category-base collisions, shortcodes left in content, lazy-load
  attributes**, and the other WordPress habits, handled as listed in
  [docs/platforms.md](docs/platforms.md).
- **Classic themes, page builders and block themes.** The build keeps the theme's CSS, pruned to
  the rules the pages use, and the per-page inline styles block themes emit.
- **Forms** post to a third-party endpoint you name at intake. Analytics, tag managers, consent
  banners and chat widgets are carried over by list, so nothing is silently dropped.
- **Redirects** the old site performs (including `www` and trailing-slash rules) become host
  rules, and the launch skills check that every old URL still lands somewhere.

What a static site cannot do (site search, comments, carts, logins, user-generated content) is
found at intake and reported as out of scope with the options: a third-party embed, keeping that
part on the old platform under a subdomain, or a separate project.

## What it refuses

To run on end-of-life Node; to submit forms or log in on the live site; to touch DNS; to commit
anything but the scaffold to `main` (all work goes on `astro-rebuild` and reaches `main` through
a pull request you merge); to soften a gate. One site per run.

## Security

The converted site is static HTML, CSS, images and the scripts you keep. There is no PHP and no
Node running on your server, so a runtime vulnerability has nothing to attack there. The build
tooling runs Node on your machine and in CI and has to stay patched; third-party scripts you keep
are their vendor's responsibility; TLS and security headers are handled at your host's edge, with
a baseline set shipped in `vercel.json` or `_headers`. More in [docs/security.md](docs/security.md).

## Requirements

- Node 22.23.4 or newer on the 22 line, or 24.22.1 or newer. Node 20 is end of life and refused.
- git, and a GitHub account with `gh` logged in if you want the repo and PR created for you.
- A Vercel or Cloudflare account for staging and production. Optional for the conversion itself.
- Playwright's Chromium (`npx playwright install chromium`), for screenshots and visual review.
- macOS or Linux. Windows is not supported in this version.
- A coding agent that can run shell commands. If your agent has its own browser or can run
  subagents, the skills use them; without them every step still runs.

Further reading: [hosting](docs/hosting.md), [platforms](docs/platforms.md),
[dependencies](docs/dependencies.md), [FAQ](docs/faq.md). [AGENTS.md](AGENTS.md) tells an agent
which skill to use when.

## Licence

MIT. See [LICENSE](LICENSE).

© ethanplusai · MIT · ethanplusai/astro-conversion-kit

Похожие плагины

Все плагины по теме «Фронтенд и UI» →
astro-seo jdevalk Скилл astro-seo для Claude Code проверяет SEO-настройки сайта на Astro и предлагает правки в коде. Проверяет метаданные, структурированные данные и индексацию. CX Codex +1 565установок seo-meta-optimizer Seth Hobson Субагент seo-meta-optimizer для Claude Code, Codex и Cursor, который готовит мета-теги, описания и URL для новых страниц. Берёт контент и ключевые слова, отдаёт готовый пакет: title, description, структуру ссылки. CX Codex ★ 42 780звёзд репо astro-expert 0xfurai Субагент astro-expert помогает проектировать сайты на Astro, настраивать коллекции контента и ускорять сборку страниц. CX Codex ★ 1 029звёзд репо astro astrolicious Страницы, компоненты, адаптеры SSR, коллекции контента и деплой на Astro. Покрывает старт проекта и работу с существующим. CX Codex +1 20 000установок clerk-astro-patterns clerk Скилл clerk-astro-patterns для Claude Code подсказывает правила интеграции аутентификации Clerk в проекты на Astro 5. Помогает настроить middleware, серверный рендеринг и островные компоненты. CX Codex +1 15 000установок astro-framework delineas Скилл astro-framework для Claude Code и других агентов: разбирается в islands architecture, гидратации и Content Layer API. Решает, что рендерить на сервере, а что в браузере, когда проект на Astro растёт. CX Codex +1 2 200установок

Из того же набора9

suggest-improvements Скилл suggest-improvements для Claude Code формирует отчёт об ошибках и недочётах конвертированного сайта по восьми направлениям. Запускается перед открытием pull request и сам ничего не правит. CX Codex +1 ★ 137звёзд репо launch-audit Скилл launch-audit для Claude Code проверяет сайт перед запуском или после него. Он также включается при переезде на новый домен и запросе на QA сайта. CX Codex +1 ★ 137звёзд репо post-launch Скилл post-launch для Claude Code проверяет сайт сразу после переезда DNS и потом тридцать дней подряд. Включается на вопрос, живой ли сайт после смены домена. CX Codex +1 ★ 137звёзд репо pre-launch Скилл pre-launch для Claude Code проверяет сайт перед публикацией и блокирует запуск при проваленных проверках. Запускается перед релизом, переносом DNS или заменой существующего сайта. CX Codex +1 ★ 137звёзд репо visual-review Скилл visual-review для Claude Code доказывает, что пересборка на Astro совпадает с живым сайтом: снимает полноэкранные скриншоты обеих сторон и считает пиксельный диф. CX Codex +1 ★ 137звёзд репо convert-site Скилл convert-site для Claude Code переносит сайт в статический Astro, сохраняя его URL, контент и оформление. Запускается по просьбе перенести, пересобрать или клонировать сайт. CX Codex +1 ★ 137звёзд репо parity-gates Скилл parity-gates для Claude Code замораживает состояние сайта в baseline/ и проверяет, что новая Astro-сборка совпадает с ним. Запускается при сверке редиректов и тестировании деплоя. CX Codex +1 ★ 137звёзд репо capture-site Скилл capture-site для Claude Code сохраняет живой сайт в папку capture/ для последующей проверки пересборки. Запускается перед переносом сайта или по просьбе сделать его снимок, инвентаризацию либо повторить прерванный сбор. CX Codex +1 ★ 137звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой