Возьмите чек-лист проверки сайта и оформите его как инструкцию в файле SKILL.md: задайте область проверки, порядок действий и формат отчёта. Так вы создадите скилл Claude Code для повторяющейся задачи, например проверки страницы перед публикацией. Ниже разберём, как подготовить такую инструкцию, подключить её к проекту и проверить на ошибке, которую вы заранее добавили в копию страницы. Этот подход подойдёт владельцу бизнеса, который дорабатывает сайт с ИИ и хочет понимать, что именно помощник проверил.
Какой чек-лист подойдёт для первого скилла?
Начните с одной задачи: проверить страницу услуги перед публикацией. Запрос «проверь весь сайт» оставляет слишком много свободы. Claude придётся самому решать, что важнее: текст, ссылки, внешний вид или код формы. Для первой версии ограничьте проверку конкретной страницей и заранее назовите признаки ошибки.
Для сайта небольшой компании в Беларуси можно взять страницу с описанием услуги и формой заявки. Скилл будет искать недостающий заголовок, ссылки без адреса и поля без понятных подписей. Цены и условия он должен сверять только с материалами, которые вы ему передали: угадывать актуальную стоимость по тексту соседней страницы нельзя.
- У страницы есть основной заголовок, который объясняет её содержание.
- У кнопок и ссылок есть понятное назначение и адрес перехода, если он нужен.
- У полей формы есть подписи, по которым посетитель понимает, что вводить.
- В тексте нет явных заглушек и обещаний, которые противоречат исходному заданию.
- Отчёт отделяет ошибки от предположений и перечисляет то, что проверить не удалось.
Перепишите расплывчатые пункты через наблюдаемый результат. Вместо «проверить удобство формы» укажите: «найти поля без подписей и проверить, предусмотрены ли сообщения об ошибке». Для оценки удобства на телефоне понадобится отдельный просмотр страницы в браузере.
Как оформить инструкцию в SKILL.md?
Скилл Claude Code — это инструкция для определённой задачи, которую помощник использует в работе. В SKILL.md задают описание скилла и правила его выполнения. Рядом можно держать вспомогательные материалы, например подробный чек-лист. Скиллы и шаблоны инструкций разобраны в русскоязычном руководстве по Claude Code на GitHub, которое входит в источники этой статьи.
Для первого варианта достаточно одного файла внутри проекта. Если Claude Code ещё не настроен, сначала разберите как выбрать скилл и безопасно подключить его к проекту: текст инструкции сам по себе не даёт доступа к браузеру или другим инструментам.
- Создайте в проекте папку .claude/skills/site-check/.
- Добавьте в неё файл SKILL.md.
- В начале файла разместите YAML-блок между строками из трёх дефисов. Укажите поля name: site-check и description: Проверяет страницу сайта по чек-листу перед публикацией и готовит отчёт без изменения файлов.
- Под этим блоком запишите рабочую инструкцию из следующих абзацев.
Задача. Проверь страницу, которую указал пользователь. Перед началом назови файлы и материалы, которые собираешься изучить. Если непонятно, где находится страница, задай уточняющий вопрос. Не расширяй проверку на весь проект без согласования.
Порядок проверки. Изучи страницу и связанные с ней компоненты. Проверь основной заголовок, назначение кнопок, адреса ссылок, подписи полей и явные текстовые заглушки. Сверяй содержание с заданием пользователя, если оно доступно. Для каждого замечания укажи пункт чек-листа.
Границы. Не меняй файлы, не устанавливай пакеты и не отправляй формы. Не объявляй страницу исправной по одному лишь чтению кода. Если нет доступа к запущенному сайту или нужному инструменту, назови проверку, которую выполнить не удалось.
Результат. Для каждой находки укажи место, наблюдение, последствие для посетителя и способ ручной проверки. Отдельно перечисли пункты без замечаний и пункты, которые остались без проверки. Предложения по оформлению помечай как рекомендации.
Это заготовка для конкретного проекта. Например, на сайте без формы уберите пункты о полях, а для страницы с несколькими вариантами заказа уточните, куда должна вести каждая кнопка. После этих правок инструкция уже задаёт понятные границы: можно пробовать первый запуск.
Как проверить, что скилл находит реальные ошибки?
Запустите его на копии страницы с заранее известным дефектом. Например, уберите адрес у ссылки, которая должна открывать страницу услуги. В задании назовите страницу, но не подсказывайте место ошибки: иначе вы проверите способность Claude выполнить подсказку, а не пройти чек-лист.
Для первого запуска подойдёт такой запрос: «Используй скилл site-check для проверки страницы услуги. Файлы не меняй. Покажи подтверждённые замечания, способ их воспроизведения и проверки, которые ты не выполнил». Перед запуском убедитесь, что работаете с копией или отдельной веткой проекта.
Сверьте отчёт с дефектом, который вы внесли. Полезная находка указывает конкретную ссылку и объясняет, что произойдёт при нажатии. Фраза «навигация требует доработки» не позволяет проверить вывод. Если Claude пропустил ошибку, уточните соответствующий пункт SKILL.md и повторите запуск.
Затем восстановите ссылку и проверьте страницу ещё раз. Старое замечание должно исчезнуть. Так вы проверите, реагирует ли скилл на состояние страницы, а не повторяет ли прежний ответ. Похожий принцип разобран в материале о том, как проверить, что тесты Claude Code находят ошибки.
Чтение кода не подтверждает весь путь посетителя. Кнопка может присутствовать в файле, но перекрываться другим элементом на экране. Поэтому в отчёте полезна точная формулировка: «адрес ссылки найден в коде; переход в браузере не проверен».
Типичные ошибки при создании скилла
- Слишком широкая задача. «Проверить качество сайта» замените перечнем признаков, которые Claude должен искать на конкретной странице.
- Проверка сразу с исправлениями. Сначала получите отчёт и подтвердите находки, затем отдельно поручите правки.
- Уверенный вывод без доказательства. Требуйте путь к файлу или описание элемента, а также действие, которым можно воспроизвести проблему.
- Лишние разрешения. Для чтения страницы и подготовки отчёта не выдавайте доступ к публикации сайта и рабочим сервисам.
- Устаревший чек-лист. После изменения формы или структуры страницы обновите инструкцию и повторите контрольный запуск.
Фраза «не меняй файлы» в SKILL.md задаёт правило поведения, но не заменяет ограничения инструментов. Проверьте доступные разрешения отдельно. Для первого запуска оставьте только те действия, которые нужны для чтения проекта и согласованной проверки.
Когда дорабатывать скилл, а когда нужна помощь?
Дорабатывайте скилл по конкретному пропуску. Если он не заметил пустую ссылку, уточните проверку адресов. Если смешал ошибку с пожеланием к дизайну, разделите эти категории в формате отчёта. Не добавляйте большой раздел «на всякий случай»: каждый новый пункт должен отвечать на понятный вопрос владельца сайта.
Помощь разработчика нужна, когда чек-лист требует действий, которых пока нет в рабочей среде: открыть страницу в браузере, воспроизвести ошибку интерфейса или запустить тесты проекта. Задание на такую работу можно сформулировать предметно: подключить нужную проверку, показать контрольный пример и объяснить, как повторить запуск.
Проверку безопасности лучше оформить отдельной задачей. Поиск пустых ссылок не подтверждает защищённость сайта, а длинный список предполагаемых уязвимостей ещё требует разбора. Для такой работы пригодится инструкция, как проверить отчёт Claude Code об уязвимостях сайта.
Сейчас потратьте одну минуту: откройте свой чек-лист и перепишите один пункт так, чтобы по нему можно было однозначно показать ошибку на странице.
