К основному содержанию
скилл CX Codex

pre-launch — скилл для Claude Code: проверка перед запуском

Скилл pre-launch для Claude Code проверяет сайт перед публикацией и блокирует запуск при проваленных проверках. Запускается перед релизом, переносом DNS или заменой существующего сайта.

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

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

Что делает pre-launch

pre-launch проверяет репозиторий и production-сборку сайта: ищет заглушки и утёкшие адреса разработки, проверяет результат сборки, настройки фреймворка и редиректы со старого сайта. Сборка выполняется заново, если не передан флаг --skip-build. Проваленная проверка даёт код выхода 1; код 2 означает ошибку запуска или ввода-вывода.

Скилл записывает отчёт и файл прогресса, но не меняет файлы сайта, не отправляет формы и не переключает DNS. Сборка проекта всё же может записывать свои файлы. Для запуска нужны production URL и Node; при сборке могут понадобиться имена переменных окружения, а для замены сайта — URL прежнего сайта, пока он доступен.

После прохождения автоматических проверок скилл ведёт человека по контрольному списку. Переносить его пункты местами нельзя: экспорт данных Search Console должен пройти до смены DNS, а проверка форм — до публикации.

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

  • проверить production-сборку сайта перед публикацией
  • найти заглушки и адреса разработки в репозитории
  • проверить страницы, метаданные, sitemap и внутренние ссылки в сборке
  • сверить редиректы при замене существующего сайта
  • пройти ручные проверки перед переносом DNS

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

  • Проверь репозиторий перед запуском сайта и покажи, что блокирует релиз.
  • Проведи проверку перед переносом DNS для production URL и старого сайта.
  • Проверь готовность сайта к публикации и проведи меня по ручному списку.

Как установить pre-launch

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

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

Команда ставит плагин astro-conversion целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add ethanplusai/astro-conversion-kit --skill pre-launch -a claude-code

3Вручную: положить файлы

~/.claude/skills/pre-launch/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pre-launch/

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

Вопросы о pre-launch

Как установить pre-launch в Claude Code?

Добавь маркетплейс командой /plugin marketplace add ethanplusai/astro-conversion-kit, затем установи плагин командой /plugin install astro-conversion@astro-conversion-kit.

Что делает pre-launch?

Проверяет репозиторий, production-сборку и покрытие редиректами, затем предлагает пройти ручной контрольный список. Любая проваленная автоматическая проверка блокирует запуск.

Что нужно для работы pre-launch?

Нужны Node и production URL. Для сборки указываются имена нужных переменных окружения; при замене сайта также нужен URL прежнего сайта, пока он доступен.

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

SKILL.md · MIT
---
name: pre-launch
description: Gate a website launch from its repository — repo hygiene, placeholders and leaked dev hosts, the production build, the build output (404 page, internal references, icons, social cards, robots, sitemap, canonicals, titles, headings), framework configuration, and redirect coverage for the site being replaced — then walk the human checklist no script can verify. Use before any site launch, before a DNS cutover, when a site is replacing an existing one, or when somebody asks whether a site is ready to launch. Read-only apart from its own report and a progress file; it exits 1 if anything fails.
---

# pre-launch

The gate. It inspects the repository and the build, and it blocks the launch if anything
mechanical is wrong. Then it hands you up to nine things no script can check.

## The two rules

**Never declare the site ready while any check fails.** There is no flag that turns a failure into
a warning, and adding one would be the wrong fix. Exit 1 means not ready. If you believe a check is
wrong about this site, say so plainly to the human and fix the check — do not route around it.

**Never reorder the human list.** Its order is a dependency order with two one-way doors in it:
the Search Console baseline must be exported **before DNS moves**, and the forms must reach a real
person **before the deploy** that makes them public. Both are unrecoverable if taken late.

## Read-only

The gate is read-only with respect to the site. It reads the repository, runs the project's own
build command, and fetches the predecessor site's sitemap when you give it one. It writes exactly
two things of its own, both the operator's record: the report bundle, and `.launch-progress.json`
in the repository being gated (only when you pass `--confirm` or `--reset-progress`). It never
edits the site, submits a form, flips a setting, calls a provider API, or touches DNS.

The one exception is deliberate: unless you pass `--skip-build`, the gate runs the project's own
build script, so whatever that build writes — `dist/`, a cache, packages it installs — is written,
because it is the project's build. Say so if somebody asks whether the gate is safe to run.

Three rules follow from that, and you restate them when you report:

1. **Evidence for every finding.** A file path, a line, a url, an exit code.
2. **A skip is not a pass.** Every skipped check carries a reason and appears in **Not covered**.
3. **`Not covered` is never a pass.** You repeat that section to the human verbatim.

## 1. Gather the inputs

Ask for anything you do not already know. Do not guess any of these.

- **The production url.** Required. Every host comparison in the gate is against it. A gate run
  against the wrong host reports confidently and means nothing.
- **Is this replacing an existing site?** If yes, get the old site's url. The gate fetches its live
  sitemap, and that can only happen **while the old site is still reachable** — usually before DNS
  moves. After the cutover this check can never be run.
- **Environment variables the production build needs.** Names only, never values.
- **Any internal or preview hostnames** that might have leaked into the build.
- **Where the build output goes**, if it is not `dist`, `out`, `build`, `_site` or `public`.

A repository may already answer these in a `.launch.json` — see `references/config.md`. If one
exists, read it and confirm it is current rather than re-asking.

## 2. Run the gate

Run the script; never read its source, and never reimplement what it does.

    node scripts/pre-launch.mjs --dir <repo> --production-url <url> --out <dir>

The path is relative to this skill's own directory — run the command from there, and point
`--dir` at the repository being launched. The bundle is written under the **current working
directory**, not under `--dir` and not next to the skill: without `--out` it lands in
`./website-launch/<host>-pre-launch-<date>/`, which with the command above means inside this
skill's own directory. Write the bundle wherever the work lives with `--out`.

Other flags: `--predecessor-url <url>`, `--build-dir <dir>`, `--required-env <NAME>` (repeatable),
`--dev-host <host>` (repeatable), `--ignore-dir <dir>` (repeatable), `--strict`, `--skip-build`,
`--out <dir>`, `--config <path>`, `--json`, `--help`.

`--ignore-dir` is for a folder committed alongside the site that is not the site, such as the raw
HTML captured from the old site during a conversion (`--ignore-dir capture`). The path is relative
to `--dir`. The repository scans (nested git, committed secrets, placeholder source) skip it;
`hygiene.env-tracked` still catches a tracked `.env` inside it, and **Not covered** says
`ignored by request: <dirs>` (a folder that does not exist is marked `(not present)`). The build
folder is what deploys, so an `--ignore-dir` that is, holds or sits inside it is refused with exit
2, and every build-output check reads it in full. It is never a way to quiet a finding about the
site itself: see "Never suppress" below.

It runs the project's build first, so the output it inspects is never stale. Use `--skip-build`
only when you have just built and nothing has changed since.

**Exit codes:** `0` passed, `1` at least one check failed, `2` a usage or IO error.

## 3. Triage — every failure blocks

Read `report.md` in the bundle it names. `references/reading-the-gate.md` has the status table and
the bundle layout. Then, in this order:

1. **Read every failing check before fixing anything.** Thirty failures from one template is one
   fix, and you cannot see that one at a time.
2. **Fix causes first.** If `build.succeeds` failed, every `output.*` result is meaningless — they
   read whatever was on disk from last time. Fix the build, rerun, read again.
3. **Fix what you can, in the repository.** Placeholder ids and copy, missing environment
   variables, a wrong site url in the generator config, a missing redirect entry, an og:image at
   the wrong size, a missing canonical — these are yours to fix. Do them.
4. **Never suppress.** Do not add a flag, do not edit a check to pass, do not exclude a file from a
   scan to quiet it. If a check is genuinely wrong, correct the check in the source and tell the
   human you did.
5. **Rerun until the gate passes.** A partial pass is not a pass.

An **advisory** result does not block. Report it, do not fix it silently, and do not describe it as
a failure. A **skip** is not a pass either — read its reason and decide whether the thing it could
not check still needs a human.

## 4. Walk the human checklist, one item at a time

Only after the gate passes. The full text for each item — why it matters, how to verify it, and
what "done" looks like — is in `references/human-checklist.md`. Read the item before you ask.

Work **one at a time**. Ask, wait for an actual answer from the person who owns the thing, and only
then record it:

    node scripts/pre-launch.mjs --dir <repo> --confirm <id>

    node scripts/pre-launch.mjs --dir <repo> --progress

`--progress` prints the list with ✓ and ☐, so a session that ends halfway resumes where it stopped.
`--reset-progress` clears it. Pass `--predecessor-url` (or `--config`) to these commands too — the
list is conditional, and without it `gsc-baseline` is not offered and "every item is confirmed"
would be premature.

Never confirm an item on somebody's behalf. Never confirm one because it is probably fine. "The
endpoint returns 200" is not a confirmed `forms` item; a named human saying "yes, I received it in
the inbox I read" is.

The ids, in their fixed order:

    forms  analytics  hosting  payments  legal  gsc-baseline  dns  signoff  rollback

`payments` appears only when the repository uses a payment SDK. `gsc-baseline` appears only when
you gave a predecessor url.

## 5. If a site is being replaced

Read `references/predecessor-redirects.md` before you touch the redirect map. The method in one
line: the old sitemap is the source of truth, keep the same path wherever you can, one explicit
301 per url that moved, no wildcards over content, no chains, take the Search Console export
before DNS moves, keep the old host up through propagation, and do not delete the old sitemap.

The single most common mistake is a wildcard that looks like coverage: `/legacy/*` to the homepage
answers forty old articles with one page, returns 200 for all of them, and loses every ranking.
The gate fails it and quotes the rule.

## 6. Present the result

Lead with the decision, not a count.

1. **The verdict.** "The gate fails: six checks" or "The gate passes." One sentence.
2. **What blocks it**, grouped by cause rather than by check, with the fix named. "Every page is
   missing a canonical — it is one layout, so it is one fix."
3. **Advisories**, marked clearly as not blocking.
4. **Not covered, verbatim.** Every line, unedited. Never summarise it, never call it minor, never
   leave it out because the list is long.
5. **The human checklist**, with what is confirmed and what is next.

## The two checks that never run

Every report ends with these, and they are there because they are the two failures that hurt most
and that no checker can reach:

- **Copy vs. source documents.** Nothing here compares the words on the pages against the
  signed-off copy. Somebody has to sit with both and read.
- **Pages vs. agreed scope.** Nothing here knows which pages were supposed to exist. A page that
  was never built is invisible to a checker.

Say both out loud. A repository can pass every check in this skill and still be missing half of
what was agreed.

## References

| File | Covers |
|---|---|
| `references/reading-the-gate.md` | The four statuses, the six groups, the bundle, how to triage |
| `references/human-checklist.md` | Each item: why it matters, how to verify it, what done looks like |
| `references/predecessor-redirects.md` | The migration method: sitemaps, same-path, wildcards, chains, the baseline |
| `references/framework-hints.md` | What the detector reads per stack, the redirect formats, how to fix each hint |
| `references/config.md` | The `.launch.json` schema, with an example and what not to put in it |

## Where this sits

`pre-launch` is this one: it runs against the repository before deploy and it blocks.
`launch-audit` crawls a staging or live url and reports without blocking. `post-launch` runs the
moment DNS moves and diffs production against the baseline. Run them in that order.

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

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
migrate-site calm-north Скилл migrate-site для Claude Code помогает спланировать перенос сайта и снизить риск потери поискового трафика. Включается при смене домена, CMS, структуры URL или дизайна. CX Codex +1 2 100установок domain-migration illyism Скилл domain-migration для Claude Code готовит перенос сайта на новые URL с настройкой редиректов и SEO-правок. Запускается при смене домена, объединении сайтов или массовой смене URL. CX Codex +1 395установок domain-strategy rampstackco Скилл domain-strategy помогает спланировать DNS-архитектуру, выбрать канонический адрес между apex и www, а также упорядочить редиректы и регистраторов в портфеле сайтов. CX Codex +1 283установок rebranding-strategy kostja94 Скилл rebranding-strategy ведёт ребрендинг от аудита до объявления: карта 301-редиректов, чек-лист миграции, коммуникация внутри команды и в соцсетях. CX Codex +1 1 200установок canonical-tag kostja94 Скилл canonical-tag разбирает дубли страниц по протоколу, хосту, слэшам и параметрам и говорит, где ставить редирект, а где canonical. CX Codex +1 1 200установок wix-manage wix Скилл wix-manage для Claude Code и ещё пяти платформ управляет бизнес-сущностями и настройками сайтов Wix через REST API. Автоматизирует работу с магазином, SEO, приложениями и аналитикой прямо из чата. CX Codex +1 803установок

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

astro-conversion Плагин astro-conversion для Claude Code переносит WordPress или другой сайт, доступный по HTTP, в статический Astro. Он собирает сайт и проверяет маршруты, SEO-данные и визуальное сходство. ★ 137звёзд репо 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звёзд репо 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звёзд репо

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

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