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

suggest-improvements — скилл для Claude Code

Скилл suggest-improvements для Claude Code формирует отчёт об ошибках и недочётах конвертированного сайта по восьми направлениям. Запускается перед открытием pull request и сам ничего не правит.

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

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

Что делает suggest-improvements

Скилл запускает скрипт scripts/suggest.mjs, который сравнивает сохранённые снимки и анализирует сайт по категориям: SEO, ссылки, текст, доступность, скорость, безопасность, аналитика и дизайн. На каждую проблему формируется запись с путём к странице, доказательством из снимка, оценкой риска (от none до high), объёмом работ (S, M, L) и пометкой, применима ли правка автоматически. Скрипт читает только локальные папки capture/, baseline/ и review/, к живому сайту он не обращается.

Главное правило инструмента: отчёт ничего не меняет в боевой сборке. Любая правка превращается в предложение в proposals.json и попадает только в сборку с флагом PROPOSALS=on либо накатывается отдельно через convert-site --apply <id>. Это сделано специально, чтобы не ломать точное соответствие оригиналу до подтверждения человеком. Если удалить папку review/, проверки дизайна попадут в раздел не охваченных аудитом, поэтому её нужно держать на диске до генерации отчёта.

Для работы нужен Node.js и готовые папки артефактов capture, baseline и review. Итоговый отчёт записывается в Markdown-файл docs/suggestions.md и JSON-структуру suggestions.json.

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

  • составить список дефектов перенесённого сайта без изменения исходного кода
  • найти проблемы с SEO, битыми ссылками и заголовками h1 по локальным снимкам
  • оценить риски и трудозатраты на исправление каждого найденного бага
  • сформировать перечень предложений для включения в pull request

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

  • Собери отчёт по улучшениям сайта через suggest-improvements
  • Запусти проверку suggest-improvements для папок capture и review
  • Какие дефекты в SEO и верстке нашел suggest-improvements на перенесенном сайте?

Как установить suggest-improvements

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 suggest-improvements -a claude-code

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

~/.claude/skills/suggest-improvements/SKILL.md

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

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

Вопросы о suggest-improvements

Как установить suggest-improvements в Claude Code?

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

Что делает suggest-improvements?

Сканирует локальные артефакты конвертации (capture/, baseline/, review/) и генерирует отчёт с замечаниями по вёрстке, SEO, безопасности и доступности, не меняя код сайта.

Что нужно для работы suggest-improvements?

Требуется среда Node.js для запуска скрипта node scripts/suggest.mjs и сохранённые на диске каталоги capture/, baseline/ и review/.

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

SKILL.md · MIT
---
name: suggest-improvements
description: List what is worth fixing on a site the conversion reproduced as-is — SEO, content, links, accessibility, performance, security, analytics and design — each item with its path, evidence, effort, risk and whether it can be applied mechanically, plus the agent's own design and content observations. Use after the parity gates and the visual review are green and before the pull request, or when someone asks what could be better on the converted site. It changes nothing.
---

# suggest-improvements

The converted site reproduces the live site on purpose, flaws included. This skill writes down
the flaws, with evidence, so the site owner can decide which to fix. It never fixes them.

## The golden rule

**Nothing from here is applied directly.** An improvement becomes a proposal: an entry in
`proposals.json` that ships only in a `PROPOSALS=on` build until a person approves it, or a later
`convert-site --apply <id>` run that does the same on its own commit. Editing the default build
because this report said so breaks parity, and the gates will say so.

## When to run

After every parity gate passes and the visual review is green for every page, with `review/`
still on disk (it feeds the design checks), and before the pull request is opened. The report
goes in the PR.

## The command

From the site root:

    node <skill-dir>/scripts/suggest.mjs --capture capture --baseline baseline --review review --out docs/suggestions.md --json suggestions.json

Add `--gates gates.json` when the gate runner wrote that file (the header then summarises the
gates), and `--lighthouse capture/lighthouse-live` when that folder exists (it is also the
default). Run `node <skill-dir>/scripts/suggest.mjs --help` for every option.

Exit 0 means the report was written, whatever it found; 2 is a usage error or a missing input.
It reads `capture/`, `baseline/` and `review/` only and never requests the live site.

## Reading the report

`docs/suggestions.md` opens with the site, the counts and the gates line, then the
**Not covered** list, then one section per category: SEO, Content, Links, Accessibility,
Performance, Security, Analytics, Design. Inside each, one heading per check with its reason,
then one line per item:

    - `/about/` `h1` (`missing-h1`, effort S, risk low)
      - Evidence: no <h1> on the page

- **Path** is the page (for a site-wide problem, the first page it appears on).
- **Effort** is S, M or L; **risk** is none, low, medium or high; **applyable** means
  `convert-site --apply <id>` can make the change mechanically.
- **Evidence** is what the check saw in the capture: a value, a count, the pages.
- **Grouped items.** One problem repeated across the site (a script in the header, an image, a
  link, a title) is one item, not one per page. The evidence names the page count and the first
  three pages; `pages` in `suggestions.json` lists every page it applies to. Use the JSON when
  you need the full list.
- The report ends with **How to apply**, listing the checks that can be applied mechanically.

**Not covered is never a pass.** A check with no input (no `--review`, no Lighthouse reports, no
`media.json`) is listed there, and so is part of one. A check that threw is listed as
`check failed: <message>`; a check whose coverage note threw keeps its items and is listed as
`(partly): coverage note failed: <message>`. The other checks still ran. Quote the whole Not covered list verbatim in the PR, unedited. If
`--review` was missing because `review/` was deleted, rerun the visual review's shoot and styles
steps and run this again rather than shipping the gap.

## What you add by hand

The scripts cannot see everything. At the end of `docs/suggestions.md`, add a section:

    ## From the review

    - `/services/` hero: the heading overlaps the image at 390 px on live and new alike
      - Evidence: review/index.html, pair /services/ at 390, top of page

What goes there:

1. **Design observations from the contact sheet**: anything that looks wrong on live and was
   reproduced faithfully (cramped spacing, an image cropped badly on mobile, low contrast, a
   misaligned grid). Name the route and width.
2. **Content issues noticed while building**: typos, outdated copy, dead offers, a phone number
   that differs between pages, a page that duplicates another. Quote the text and name the
   captured file it came from.

Each line carries the same discipline as the script's items: a path, evidence a person can check
(a route and width on the contact sheet, a file under `capture/`, a quoted snippet), and nothing
you did not see. No guesses, no "probably". If the list is empty, write "Nothing further noticed."
so the reader knows you looked.

Do not rerun the script after adding the section: it rewrites `docs/suggestions.md`. Rerun it
first if the inputs changed, then add the section again.

## Acting on an item

Never in this run. When the person picks an item:

- **Applyable checks**: `convert-site --apply <id>` records the proposal in `proposals.json`,
  makes the change on its own commit, reruns the gates and the contact sheet, and ships it only
  with `PROPOSALS=on`.
- **Everything else** (alt text, copy, which duplicate page to keep, a design fix): a person
  decides or writes it, and it goes in as a proposal the same way, never into the default build.

## The checks

`references/catalogue.md` lists every check: its id, category, what it looks for, the evidence it
cites, its default effort and risk, whether it is applyable, which checks group across pages, and
which inputs each check needs. Read it when an item's reason is unclear or a check is missing
from the report.

## Present the result

1. **The counts per category**, then the items with risk medium or high and the applyable ones.
2. **From the review**, every line.
3. **Not covered, verbatim**: every line of the report's list, unedited. None of it was checked.
4. **What happens next**: nothing is applied until the person picks items; each becomes a
   proposal or a `--apply` run.

## References

| File | Covers |
|---|---|
| `references/catalogue.md` | Every check, its evidence, effort, risk, applyability and inputs |

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

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

Все скиллы по теме «Код-ревью и рефакторинг» →
audit-website squirrelscan Скилл audit-website для Claude Code проверяет сайт и помогает исправить найденные проблемы в коде. Запускает аудит по запросу проверить сайт или веб-приложение. CX Codex +1 75 200установок code-reviewer nodnarbnitram Скилл code-reviewer для ревью кода: проходит по чек-листу из читаемости, безопасности, обработки ошибок, производительности и тестов, а замечания сортирует по критичности. CX Codex +1 298установок Web Auditor yakenator MCP-сервер Web Auditor проверяет страницы и целые сайты на SEO, безопасность, скорость и доступность по стандартам WCAG. Составляет списки проблем и сохраняет историю аудитов. CX Codex +1 3 818установок audit-project Community Плагин audit-project для Claude Code, запускающий итеративную проверку кода силами нескольких субагентов. Работает, пока список замечаний не опустеет. ★ 2 003звёзд репо astro-seo jdevalk Скилл astro-seo для Claude Code проверяет SEO-настройки сайта на Astro и предлагает правки в коде. Проверяет метаданные, структурированные данные и индексацию. CX Codex +1 565установок Keyword Research — Google Suggest, Intent & Long-Tail axel-belfort Keyword Research — Google Suggest, Intent & Long-Tail — MCP-сервер для поиска ключевых слов через Google Suggest, классификации намерений и длинных хвостов для контента, PPC и анализа конкурентов. CX Codex +1 6 583установок

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

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

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

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