SEO-навыки для Claude Code: как научить ассистента вашей методике аудита

У Claude Code есть механизм навыков: вы записываете свою методику в файл, и ассистент подхватывает её, когда задача подходит. Для SEO это способ превратить «спроси у Пети, он знает порядок проверок» в воспроизводимый регламент.

Разберём, как это устроено, чем отличается от MCP и где граница пользы.

Что такое навык

Навык — это папка с файлом SKILL.md. Файл начинается с блока метаданных:

---
name: seo-audit
description: Регламент SEO-аудита сайта. Использовать, когда просят
  проверить сайт, найти причины падения трафика или собрать отчёт
  по индексации и поведенческим показателям.
---

# Порядок аудита

1. Индексация: сколько страниц в поиске, что выпало за 30 дней и почему
2. Позиции: запросы на местах 4–15, запросы с просадкой больше 5 пунктов
   ...

Ключевое в устройстве — прогрессивная загрузка. Постоянно в контексте ассистента лежит только строка description. Полный текст навыка подгружается, когда модель решит, что задача ему соответствует. Поэтому десяток навыков не засоряет контекст: активируется тот, что нужен.

Отсюда практическое следствие: description пишется как условие срабатывания, а не как описание содержимого. «Регламент SEO-аудита» — плохо, модель не поймёт, когда его применять. «Использовать, когда просят проверить сайт или найти причины падения трафика» — хорошо.

Где живут навыки

Два места:

• ~/.claude/skills/<имя>/SKILL.md — персональные, работают во всех проектах.
• .claude/skills/<имя>/SKILL.md внутри репозитория — проектные, коммитятся вместе с кодом.

Второй вариант интереснее для команды: регламент лежит в репозитории, обновляется через пул-реквест, и у всех специалистов аудит идёт по одной методике. Это, пожалуй, главная польза механики — не скорость, а единообразие.

Навык и MCP-сервер: разные слои

Их часто путают, потому что оба «расширяют возможности ассистента». Но отвечают они на разные вопросы.

Простая проверка: попросите ассистента с установленным SEO-навыком, но без подключённых данных, разобрать падение трафика. Он честно пройдёт по всем пунктам вашего регламента — и на каждом выдаст правдоподобные, но выдуманные цифры. Методика есть, данных нет.

Обратная ситуация: данные подключены, навыка нет. Ассистент ответит на конкретный вопрос, но порядок проверок придётся задавать вручную каждый раз, и у двух специалистов аудит выйдет разным.

Работают они вместе: навык говорит «проверь индексацию первым делом и считай проблемой, если из поиска выпало больше 5% важных страниц», MCP-сервер даёт инструмент, которым эта проверка выполняется. Что такое MCP и как он устроен — в отдельной статье.

Как написать SEO-навык под себя

Готовые навыки в открытом доступе есть, но они задают чужую методику — чужие пороги, чужой набор проверок, чужой формат отчёта. Если у вас принят другой регламент, дешевле описать свой.

Шаг 1. Возьмите то, что уже есть. У большинства специалистов регламент существует — в голове, в заметке или в шаблоне отчёта. Начните с него, а не с чистого листа.

Шаг 2. Опишите порядок и пороги. Именно пороги отличают навык от общих слов. Не «проверить отказы», а «найти страницы с отказами выше 60% при трафике от 100 визитов». Не «посмотреть позиции», а «выгрузить запросы на местах 4–15 с показами от 100 за 28 дней».

Шаг 3. Укажите инструменты явно. Если у вас подключён MCP-сервер, назовите в навыке конкретные инструменты для каждого шага. Тогда ассистент не будет гадать, откуда брать цифры.

Шаг 4. Задайте формат вывода. Опишите, как должен выглядеть результат: таблица, список проблем по приоритету, готовый текст для клиента. Это экономит больше времени, чем сама проверка.

Шаг 5. Напишите description как условие. Перечислите формулировки, на которых навык должен срабатывать: «проверь сайт», «почему упал трафик», «собери отчёт по индексации».

Пример структуры

---
name: seo-audit
description: Регламент SEO-аудита. Применять при запросах вида
  «проверь сайт», «почему упал трафик», «собери отчёт по проекту».
---

# Порядок

## 1. Индексация

Инструменты: get_webm_indexing_samples, gsc_inspect_url
Проблема, если: страниц в поиске меньше 70% от проиндексированных

## 2. Позиции

Инструменты: get_webm_popular_queries, gsc_quick_wins
Собрать: запросы на местах 4–15 с показами от 100 за 28 дней

## 3. Поведение

Инструменты: get_high_bounce_pages_organic
Проблема, если: отказы выше 60% при трафике от 100 визитов

## 4. Каннибализация

Инструмент: gsc_cannibalization_check

# Формат отчёта

Таблица: проблема, затронутые страницы, приоритет, что делать.
Приоритет считать по объёму потерянного трафика, не по «серьёзности».

Это скелет — под конкретный проект он обрастает деталями. Развёрнутый разбор самих шагов аудита есть в статье про SEO-аудит с помощью AI.

Почему Claude Code, а не чат

Резонный вопрос: зачем терминал, если есть обычный диалог в браузере.

Ответ в том, что в терминале ассистент видит не только аналитику. Он читает файлы проекта, запускает команды, разбирает выгрузки в CSV, смотрит логи сервера. Для части SEO-задач это принципиально:

• Сопоставить список выпавших из индекса URL с реальной структурой сайта в репозитории.
• Проверить, действительно ли на страницах с высокими отказами стоят те мета-теги, которые вы думаете.
• Разобрать логи обращений робота вместе со статистикой индексации.
• Внести правки в мета-теги сразу после того, как нашли проблему.

Если сайт и аналитика существуют для вас в разных мирах, преимущество небольшое. Если вы имеете доступ к коду проекта — заметное.

Подключается Seely к Claude Code одной командой, готовая строка с ключом есть в кабинете:

claude mcp add --transport http --scope user seely-yandex https://seely.ru/api/mcp --header "Authorization: Bearer ВАШ_API_КЛЮЧ"

Честные ограничения

Навык не делает модель умнее. Он задаёт рамку. Если методика в нём слабая, результат будет слабым, просто воспроизводимо слабым.

Срабатывание не гарантировано. Модель сама решает, релевантен ли навык задаче. При размытом description он может не подгрузиться. Если навык обязателен всегда, надёжнее позвать его явно.

Много навыков мешают. Когда описания пересекаются, модель выбирает не тот. Лучше один продуманный регламент, чем пять частично дублирующих.

Данные всё равно нужны. Это возвращает к главному тезису: навык отвечает на вопрос «как», а не «откуда». Без подключённой аналитики самый подробный регламент остаётся чек-листом, который вы будете выполнять руками.

Обзор того, какие вообще бывают MCP-серверы и что стоит подключать для SEO, — в статье про MCP-серверы для SEO.