dsh-desktop-kit 1.0.0 → 2.0.0

package/skills/seo/SKILL.md

@@ -1,329 +1,77 @@
 ---
 name: seo
-description: "SEO-эксперт: техническое SEO, on-page, структурированные данные, E-E-A-T/YMYL, контент и аудит — применять по умолчанию в любой веб-разработке"
-whenToUse: "Любая работа с сайтом/страницей/контентом: вёрстка, шаблоны, мета-теги, URL, редиректы, миграции, контент, лендинги, блоги, аудит и продвижение. Загружать до кода, если задача касается веба."
+description: "SEO веб-артефакта по умолчанию: страница, шаблон, URL, мета, JSON-LD, контент, аудит — любой веб"
+whenToUse: "Вёрстка, мета-теги, URL и редиректы, миграции, sitemap/robots, JSON-LD, статьи, аудит — грузить до кода, если задача про веб."
 user-invocable: true
 ---
 
-# SEO — эксперт по поисковой оптимизации (по умолчанию для любого веба)
+# SEO — ядро
 
-> Ты — старший SEO-специалист и техлид, который отвечает и за трафик, и за код.
-> Твоя работа — не «вписать ключевики», а сделать так, чтобы страницу **нашли**, **показали**,
-> **процитировали** (в т.ч. в ИИ-ответах) и **конвертировали**. SEO встроено в разработку с первой строки,
-> а не прикручивается после. Русский рынок: **Google + Яндекс** одновременно. Медицина — **YMYL**.
+> ≈2 000 токенов. Детали — по ссылкам, когда нужны.
 
-## 0. КОНТРАКТ (нарушать нельзя)
+## 0. Когда применять
 
-1. **SEO по умолчанию.** Любая страница, которую ты создаёшь или меняешь, получает полный набор:
-   `title`, `description`, `canonical`, `robots`, Open Graph, ровно **один H1**, семантическую разметку,
-   осмысленный `alt` у изображений, внутренние ссылки, JSON-LD, человекочитаемый URL.
-   Нет объекта «потом добавим SEO» — если страница без этого, она **не готова**.
-2. **Интент важнее ключевых слов.** Сначала определи, что человек хочет (узнать / выбрать / записаться / сравнить /
-   найти адрес), потом строй страницу под этот интент. Ключевик, вставленный без интента, — вред.
-3. **Не выдумывай цифры и факты.** Лимиты, пороги и «правила поисковиков» бери из первоисточников
-   (Google Search Central, Яндекс Вебмастер, schema.org, web.dev) — ссылки в `references/`. Где данные спорные
-   или могли измениться — пиши «**проверить на актуальной версии**» + дату проверки.
-4. **YMYL-режим для медицины.** Любой медицинский контент: автор-врач с квалификацией, дата публикации и дата
-   проверки, источники, дисклеймер, отсутствие обещаний излечения. См. `references/eeat-medical.md`.
-5. **Не ломать существующее SEO.** Перед правкой URL/шаблона/мета — зафиксируй «до» (какие URL, какие title,
-   какие редиректы). Любая смена URL = 301 + обновление sitemap + внутренние ссылки. Без этого не менять.
-6. **Проверяемо, а не «на глаз».** Итог работы подтверждается: валидатором rich results, проверкой кода страницы
-   (curl/DevTools), `robots.txt`/`sitemap.xml`, скриншотом SERP-сниппета или отчётом Lighthouse/CWV. 
-   «Я добавил meta» — не доказательство; доказательство — фрагмент HTML и результат валидатора.
-7. **Отчёт с приоритетами.** В отчёте: что сделано, что проверено, какие P0/P1 остались и почему.
+- Страница, шаблон, `<head>`, sitemap, robots, статья, услуга.
 
-## 1. ПРОЦЕСС (8 шагов)
+## 1. Главное
 
-Порядок жёсткий: шаги 1–3 — до кода, 4–7 — в коде, 8 — после. На маленькой задаче шаги сжимаются до
-нескольких минут, но **не пропускаются**.
+### 1.1 Контракт
 
-### Шаг 1. SEO-бриф и интент (до кода)
-Заполни короткий бриф (5–10 строк, шаблон в `references/content-seo.md`):
-- **Кто ищет** (пациент, родственник, врач-направленец, журналист), **что хочет** (интент), **что дальше** (CTA).
-- **Тип интента:** информационный (`что такое`, `симптомы`), коммерческий/транзакционный (`записаться`,
-  `цена`, `врач`), навигационный (`организация 31 официальный сайт`), локальный (`клиника рядом`, `адрес`).
-- **Тип страницы:** главная / направление / услуга / врач / статья / новость / цены / контакты / документы / 404.
-- **SERP-контекст:** что уже в топе (типы страниц, форматы: статья, карточка, видео, карта), какой ответ
-  пользователь считает достаточным. Это определяет формат твоей страницы.
-- **Гео:** Москва/район (для клиники — критично), филиалы, зона обслуживания.
+1. **SEO по умолчанию**: мета, `canonical`, `robots`, OG, один `H1`, семантика, `alt`, ссылки, JSON-LD, читаемый URL — иначе страница не готова.
+2. **Интент важнее ключей**: сначала что человек хочет, потом страница.
+3. **Не выдумывать цифры**: пороги — из первоисточников; спорное — «проверить на актуальной версии» + дата.
+4. **YMYL**: медицина — автор-врач, даты, источники, дисклеймер, без обещаний излечения.
+5. **Не ломать существующее**: фиксируй «до»; смена URL = 301 + sitemap + ссылки.
+6. **Доказывать**: `curl`/`view-source`, Rich Results Test, PSI/CWV, фрагмент HTML.
+7. **Мета и контент — в исходном HTML** (SSR/SSG/prerender), не после JS.
+8. **Google + Яндекс**: так, чтобы работало в обоих (`measurement.md` §10).
+9. **Отчёт**: сделано, проверено (чем), что из P0/P1 осталось и почему.
 
-### Шаг 2. Семантика и кластеры
-- **Актуальную выдачу/конкурентов/тренды проверяй через `web-research`** (живой поиск, дата, ссылки), а не по памяти модели.
-- Собери ядро: **Яндекс Вордстат** (`wordstat.yandex.ru`), подсказки Яндекс/Google, «Похожие запросы»,
-  Google Search Console (Запросы), Яндекс Вебмастер (Поисковые запросы), конкуренты в топе.
-- Раздели на **кластеры = 1 страница**. Правило: один кластер — одна страница, без каннибализации
-  (две страницы под один интент конкурируют друг с другом и обе проигрывают).
-- Для каждого кластера: главный запрос (ВЧ/СЧ/НЧ), 5–15 поддерживающих, вопросы (для FAQ-блока и ИИ-ответов).
-- Фиксируй частотность с датой и регионом (Вордстат показывает по региону — для example.org нужен **Москва**).
-- Подробно: `references/content-seo.md`.
+### 1.2 Процесс — 8 шагов (1–3 до кода, 4–7 в коде, 8 после)
 
-### Шаг 3. Архитектура URL и внутренние ссылки
-- Иерархия: `раздел/подраздел/страница`, максимум 3–4 уровня. Клиника:
-  `/napravleniya/kardiologiya/`, `/uslugi/mrt-golovy/`, `/vrachi/ivanov-ivan-ivanovich/`, `/novosti/...`.
-- URL: латиница, строчные, дефисы (`-`), без `_`, без параметров-мусора, без `.php/.html` если можно,
-  без дат у обновляемых страниц, стабильный и **без смены без 301**.
-- Внутренние ссылки: каждый важный URL достижим за ≤3 клика от главной; хабовые страницы разделов ссылаются
-  на детей; в тексте — **описательные анкоры** (не «здесь», не «подробнее»), 2–6 контекстных ссылок на 1000 слов.
-- Хлебные крошки на всех внутренних страницах + `BreadcrumbList` в JSON-LD.
-- Сирот (страницы без входящих ссылок) — нет. Проверяется краулом.
+1. **Бриф и интент**: кто, что хочет, CTA, тип страницы → `content-seo.md`.
+2. **Семантика**: Вордстат по региону, GSC; 1 кластер = 1 страница; частотность с датой.
+3. **Архитектура**: URL ≤3–4 уровня, ≤3 клика, анкоры 2–6/1000 слов, без сирот → `on-page.md`.
+4. **On-page**: `title` 50–60, `description` 140–160, один `H1`, `alt`, OG → `page-templates.md`.
+5. **Техника**: 200 + indexable, canonical, 301 без цепочек, CWV, миграции → `technical-seo.md`.
+6. **JSON-LD**: типы, FAQ-сниппета нет с 07.05.2026, поля = контент → `structured-data.md`.
+7. **E-E-A-T**: автор-врач, даты, лицензия, источники, дисклеймер, NAP → `eeat-medical.md`.
+8. **Измерение**: GSC + Вебмастер (регион, ИКС), GA4/Метрика, baseline, 2–4/8–12 недель → `measurement.md`.
 
-### Шаг 4. On-page (в коде, для каждой страницы)
-| Элемент | Правило (RU, 2026) |
-|---|---|
-| `title` | 50–60 символов (~600px), главный запрос ближе к началу, бренд в конце через `|`. Уникальный на каждой странице |
-| `description` | 140–160 символов, польза + факт (врач, цена «от», адрес, срок), не дублируется, не «купить дешево» |
-| `H1` | Ровно один, совпадает по смыслу с интентом, не равен `title` дословно |
-| `H2–H6` | Иерархия без пропусков, заголовки — реальные вопросы/подтемы, не «О нас» |
-| URL | короткий, транслит, смысловой (`/uslugi/mrt/`), без КАПСА и стоп-слов |
-| Контент | отвечает на интент в первых 1–2 абзацах; факты, цифры, имена; без воды и «Инновационных решений» |
-| Изображения | `alt` описательный (не «img1», не спам ключами), `width/height`, `loading="lazy"` ниже первого экрана, WebP/AVIF, `srcset` |
-| Внутренние ссылки | 2–6 в тексте, анкоры описательные, на релевантные страницы (не «на главную» со всех) |
-| OG/Twitter | `og:title`, `og:description`, `og:image` 1200×630, `og:url`, `og:type`, `og:locale=ru_RU` |
-| Хлебные крошки | видимые + разметка `BreadcrumbList` |
-| `robots` | `index,follow` по умолчанию; `noindex` — только осознанно и с причиной |
+**Lite-режим** (шаги сжимаются, но не пропускаются): `title` + `description` + `H1` · `canonical` + `index,follow` + OG · `header/main/article/footer`, `lang="ru"` · `alt`, размеры, lazy ниже фолда · 2–4 ссылки + крошки · JSON-LD минимального типа · гейт §3; аудит — `audit-checklist.md` §15.
 
-Детали и шаблоны: `references/on-page.md`.
+### 1.3 YMYL-медицина
 
-### Шаг 5. Техническое SEO
-Проверяй на каждой задаче (не только «когда просили»):
-- **Индексация:** страница отдаёт 200, нет `noindex`, не закрыта в `robots.txt`, есть в `sitemap.xml`.
-- **Canonical:** абсолютный, self-referencing на канонической версии; один canonical на страницу; пагинация и
-  фильтры — canonical на «чистую» версию, не на себя с параметрами.
-- **Редиректы:** 301 для постоянных, 302 — временно, 410 — для удалённого навсегда, **без цепочек** (1 прыжок),
-  HTTPS + без/с `www` — одна версия (все остальные 301 на неё).
-- **robots.txt:** не закрывать CSS/JS/картинки, не закрывать то, что нужно в индексе; `Sitemap:` с абсолютным URL;
-  лимит Google — 500 КБ. Для Яндекса дополнительно `Clean-param` для UTM/сортировок.
-- **sitemap.xml:** только 200 + indexable URL, `<lastmod>` реальный (не «сегодня» у всех), ≤50 000 URL и ≤50 МБ
-  на файл (иначе sitemap-индекс), без 404/редиректов/`noindex`. Ссылка в `robots.txt`, отправка в GSC и Вебмастер.
-- **Пагинация:** `rel=next/prev` Google не использует (но не вредит), главное — canonical на себя у каждой
-  страницы пагинации и уникальные title; `noindex` на «глубокие» страницы пагинации — только осознанно.
-- **Фасеты/фильтры:** «ценные» комбинации — индексировать, «мусорные» — `noindex,follow` или запрет в robots +
-  `Clean-param` (Яндекс), без блокировки обхода (иначе не увидят canonical).
-- **hreflang:** только если есть реальные языковые/региональные версии, взаимообразные ссылки + `x-default`.
-- **Мобильный:** mobile-first, нет горизонтального скролла, тач-цели ≥44px, шрифт ≥16px в полях.
-- **Скорость/CWV:** LCP ≤2.5 c, INP ≤200 мс, CLS ≤0.1 (75-й перцентиль, мобайл и десктоп отдельно).
-- **JS/SPA:** контент и мета должны быть в **исходном HTML** (SSR/SSG/prerender); не полагайся на клиентский
-  рендер для title/canonical/ссылок; проверяй «как видит робот» (`view-source`, `curl`, URL Inspection).
-- **Миграции URL:** карта «старый → новый», 301, обновление sitemap и внутренних ссылок, мониторинг 404 в
-  GSC/Вебмастере 2–4 недели.
+Автор-врач, рецензент, даты публикации и проверки, источники, дисклеймер, противопоказания, «когда срочно к врачу»; без обещаний излечения, запугивания, назначений «по интернету», выдуманных отзывов, цены ≠ прайс. Блокеры — `eeat-medical.md` §12.
 
-Подробно (пороги, статусы, лог-анализ, миграции): `references/technical-seo.md`.
+### 1.4 Антипаттерны
 
-### Шаг 6. Структурированные данные (JSON-LD)
-- Формат — **JSON-LD** в `<script type="application/ld+json">`, один блок-граф или несколько блоков.
-- Базовый набор для сайта: `Organization`/`MedicalOrganization` + `WebSite` (главная), `BreadcrumbList` (везде),
-  `MedicalWebPage`/`Article` (контент), `Physician` (врачи), `MedicalClinic`/`Hospital` (клиника/филиал),
-  `Service`/`MedicalProcedure` (услуги), `FAQPage` (блок вопросов — как контент, не ради сниппета).
-- **Важно (2026):** Google **отключил FAQ rich results с 07.05.2026** и убрал HowTo ещё в 2023 — разметку можно
-  оставлять (она помогает ИИ и Яндексу понимать страницу), но **не обещай** сниппет. Обещай то, что реально:
-  понимание сущностей, расширенные сниппеты там, где они ещё работают (BreadcrumbList на десктопе, Organization,
-  Article, Physician/MedicalClinic — для связывания сущностей), корректные данные для ИИ-ответов.
-- Все поля должны **совпадать с видимым контентом** (name, адрес, телефон, цены, рейтинг). Не размечай невидимое.
-- Валидация: Rich Results Test + Schema Markup Validator + Вебмастер Яндекса.
+keyword stuffing, скрытый текст, doorway, каннибализация, обещания излечения, `noindex` на деньгах, canonical на чужой URL, «мягкие 404», sitemap с 404, одинаковый `title`, lazy на LCP, выдуманные отзывы, миф про `llms.txt`. Разбор — `antipatterns.md`.
 
-Шаблоны: `references/structured-data.md`, готовые файлы — `assets/snippets/*.jsonld`.
+## 2. Куда грузить дальше
 
-### Шаг 7. E-E-A-T / YMYL (медицина — обязательно)
-- **Experience/Expertise:** автор — врач с ФИО, специальностью, образованием, стажем, ссылкой на профиль;
-  медицинский редактор/рецензент; для услуг — оборудование, методика, показания/противопоказания.
-- **Authoritativeness:** лицензия (номер, дата, орган), аккредитации, членство в профессиональных обществах,
-  ссылки на первоисточники (Минздрав, клинические рекомендации, ВОЗ, PubMed).
-- **Trust:** дата публикации **и** дата обновления/проверки, контакты, юридические данные, политика
-  конфиденциальности (152-ФЗ), отсутствие обещаний «гарантируем излечение», дисклеймер «не является
-  медицинской рекомендацией, обратитесь к врачу».
-- **Локальный бизнес:** единый NAP (название/адрес/телефон) на сайте, в Яндекс Бизнесе, 2ГИС, Google Business
-  Profile; часы работы, схема проезда, отзывы (реальные, с ответами), лицензии на видном месте.
+| Нужно | Файл | ≈токенов | Когда читать |
+|---|---|---|---|
+| Интент, кластеры | `references/content-seo.md` | 5 850 | новая страница |
+| Мета, матрица страниц | `references/page-templates.md` | 2 250 | title/description |
+| Статусы, robots, sitemap, canonical | `references/technical-seo.md` | 8 050 | техправка |
+| Title/H1–H6, URL, анкоры, OG | `references/on-page.md` | 6 400 | вёрстка |
+| JSON-LD: шаблоны, валидация | `references/structured-data.md` | 8 700 | разметка |
+| Авторство, даты, NAP | `references/eeat-medical.md` | 7 100 | медицина |
+| 107 проверок и отчёты | `references/audit-checklist.md` | 7 900 | аудит |
+| GSC, Вебмастер, KPI, UTM | `references/measurement.md` | 7 250 | замеры |
+| Laravel, Bitrix, React, статика | `references/stack-recipes.md` | 10 100 | код стека |
+| Антипаттерны | `references/antipatterns.md` | 2 050 | сомнение |
 
-Детали и текст-шаблоны: `references/eeat-medical.md`.
+Готовое — `assets/snippets/`, `assets/scripts/seo-audit.mjs`.
 
-### Шаг 8. Измерение и валидация
-- **GSC:** индексирование (URL Inspection), «Эффективность» (показы/клики/CTR/позиция), богатые результаты,
-  Core Web Vitals, «Покрытие»/«Страницы»; **AI Overviews и AI Mode учитываются в общем трафике** отчёта
-  (тип поиска «Веб») — отдельного отчёта нет.
-- **Яндекс Вебмастер:** «Индексирование → Страницы в поиске», «Поисковые запросы», «Диагностика», «Регион»,
-  ИКС; следи за исключёнными страницами и ошибками robots/sitemap.
-- **Аналитика:** GA4 + Яндекс Метрика (цели «запись», «звонок», «форма»), UTM для внешних кампаний.
-- **До/после:** зафиксируй baseline (дата, метрики) → изменения → сравнение через 2–4 и 8–12 недель.
-  Не обещай рост «за неделю».
+## 3. Гейт перед сдачей
 
-Метрики, KPI, отчёты: `references/measurement.md`.
+Порог: P0 закрыты; P1 — в отчёт с причиной; 0 ошибок валидаторов.
 
-## 2. РЕШЕНИЯ «ПО УМОЛЧАНИЮ» (матрица по типу страницы)
-
-| Тип страницы | title (шаблон) | JSON-LD | robots | sitemap | приоритет |
-|---|---|---|---|---|---|
-| Главная | `{Клиника} — официальный сайт | {город}` | Organization+WebSite+MedicalClinic | index,follow | да, priority 1.0 |
-| Направление | `{Направление} в {Клиника}, {город} — врачи, цены, запись` | MedicalWebPage+BreadcrumbList+Service | index,follow | да, 0.8 |
-| Услуга | `{Услуга} в {Клиника} — цена от {X} ₽, запись онлайн` | MedicalProcedure/Service+FAQ+Breadcrumb | index,follow | да, 0.8 |
-| Врач | `{ФИО} — {специальность}, {Клиника}, {город}` | Physician+Person+Breadcrumb | index,follow | да, 0.7 |
-| Статья/блог | `{Вопрос/тема}: {уточнение} — {Клиника}` | Article/MedicalWebPage+FAQ+Breadcrumb | index,follow | да, 0.6 |
-| Новость | `{Событие} — {дата} | {Клиника}` | NewsArticle/Article | index,follow | да, 0.5 |
-| Цены | `Цены на {раздел} в {Клиника}, {город} — {год}` | MedicalWebPage+Offer (осторожно) | index,follow | да, 0.7 |
-| Контакты | `Контакты {Клиника} — адрес, телефон, схема проезда` | MedicalClinic+Organization | index,follow | да, 0.6 |
-| Страница «спасибо»/личный кабинет | `{...}` | — | `noindex,follow` | нет | — |
-| Поиск/фильтры/мусорные фасеты | — | — | `noindex,follow` или robots+Clean-param | нет | — |
-| 404/410 | `Страница не найдена` | — | `noindex` | нет | — |
-
-## 3. ГЕЙТ КАЧЕСТВА (SEO-GATE — не сдавать, пока не всё `[x]`)
-
-**Порог:** все P0 закрыты; P1 — закрыты или явно вынесены в отчёт с причиной; 0 ошибок в валидаторах
-структурированных данных; страница отвечает 200 и индексируема.
-
-- [ ] **P0** `title` уникальный, 50–60 симв., главный запрос в начале, без «спама» и ALL CAPS.
-- [ ] **P0** `description` уникальный, 140–160 симв., с пользой/фактом.
-- [ ] **P0** ровно один `H1`, совпадает с интентом; иерархия H2–H6 без пропусков.
-- [ ] **P0** `canonical` абсолютный и корректный (self-referencing или на каноническую версию).
-- [ ] **P0** страница индексируема: 200, нет `noindex`, нет запрета в `robots.txt`, есть в `sitemap.xml`.
-- [ ] **P0** JSON-LD валиден, поля совпадают с контентом.
-- [ ] **P0** внутренние ссылки на страницу есть (не сирота), исходящие — 2–6 контекстных.
-- [ ] **P0** для медицины: автор-врач, дата публикации/проверки, источники, дисклеймер, лицензия.
-- [ ] **P1** URL читаемый, латиница/транслит, без параметров; при смене — 301.
-- [ ] **P1** OG/Twitter-теги + `og:image` 1200×630.
-- [ ] **P1** изображения: `alt`, размеры, lazy ниже фолда, WebP/AVIF.
-- [ ] **P1** хлебные крошки (видимые + `BreadcrumbList`).
-- [ ] **P1** CWV: LCP ≤2.5 c, INP ≤200 мс, CLS ≤0.1 (или зафиксированный план).
-- [ ] **P2** микроданные обновлены (`<html lang="ru">`, `<meta charset>`, viewport, favicon).
-- [ ] **P2** нет битых ссылок/404 во внутренних ссылках, нет цепочек редиректов.
-
-Полный чек-лист из 60+ проверок с приоритетами: `references/audit-checklist.md`.
-
-## 4. АНТИПАТТЕРНЫ (мгновенно убивают позиции и доверие)
-
-**Контент и переоптимизация:** keyword stuffing · текст «для роботов», не для людей · скрытый текст/ссылки ·
-двери (doorway pages) · одинаковый текст на N страниц · каннибализация запросов · заголовки-обманки
-(«Вы не поверите») · «гарантируем излечение» и любые обещания результата в медицине · контент без автора и даты ·
-копипаст с других медсайтов без переработки · автогенерация массы однотипных страниц.
-
-**Технические:** `noindex` на деньгах/услугах · canonical на чужой URL · редирект-цепочки · 302 вместо 301 ·
-дубли www/без-www и http/https · «мягкие 404» (200 на несуществующей странице) · закрытые в robots CSS/JS/картинки ·
-sitemap с 404/`noindex` · тысячи мусорных URL в индексе (фасеты, сортировки) · title одинаковый на всех страницах ·
-`H1` = логотип или отсутствует · контент только через JS без SSR · блокировка обхода ради «экономии краулинга» ·
-lazy-load на LCP-изображении · CLS из-за шрифтов/баннеров без размеров.
-
-**Медицина/доверие:** отзывы-выдумки и накрутка рейтинга · `aggregateRating` на собственные отзывы ·
-фото-стоки врачей вместо реальных · дисклеймер «мы не отвечаем» · противоречивые цены (в тексте ≠ в прайсе) ·
-разные телефоны/адреса на сайте и в Яндекс Бизнесе.
-
-**ИИ-эра:** верить в «секретный файл llms.txt» (Google официально: такие файлы ему не нужны и на ранжирование
-не влияют) · генерировать сотни ИИ-статей без редактуры (риск «scaled content abuse») · прятать контент от
-ИИ-сниппетов и ждать трафика из ИИ-ответов одновременно.
-
-## 5. ШАБЛОНЫ title / description (RU, медицина)
-
-Правило: **что + где + выгода/факт + бренд** (не обязательно все, но первые два — всегда).
-Не ставь `|` и бренд в начало. Не пиши «официальный сайт» там, где это не так.
-
-| Тип | title | description |
-|---|---|---|
-| Главная | `организация, Москва — официальный сайт больницы` | `Многопрофильная больница в Москве: консультации врачей, диагностика, стационар. Запись по телефону и онлайн. Адрес и схема проезда.` |
-| Направление | `Кардиология в организация, Москва — врачи, диагностика, запись` | `Кардиологическое отделение: ЭКГ, ЭхоКГ, холтер, консультации кардиолога. Опытные врачи, современное оборудование. Запись онлайн.` |
-| Услуга | `МРТ головного мозга в Москве — цена от 4 500 ₽, запись в организация` | `МРТ головы на аппарате 1.5 Тл: расшифровка врачом, результат в день исследования. Цена от 4 500 ₽, запись онлайн и по телефону.` |
-| Врач | `Иванов Иван Иванович — кардиолог, организация, Москва` | `Кардиолог с 18-летним стажем: диагностика и лечение гипертонии, ИБС, аритмий. Кандидат медицинских наук. Запись на приём.` |
-| Статья | `Высокое давление: причины, симптомы и когда идти к врачу` | `Почему повышается давление, какие симптомы опасны, как измерять дома и когда нужен кардиолог. Разбор врача организация.` |
-| Новость | `День открытых дверей в организация — 12 апреля 2026` | `12 апреля 2026: бесплатная проверка сердца, консультации кардиолога и эндокринолога. Программа, запись, адрес.` |
-
-Чего избегать в title/description:
-- `Купить, дёшево, в Москве недорого` для государственной клиники — конфликт с реальностью и YMYL-доверием.
-- Пунктуация-мусор `!!!`, эмодзи, слова «лучший», «№1» без доказательств.
-- Обрезанные фразы и «…» вручную — Google/Яндекс обрежут сами по ширине.
-
-## 6. РУССКИЙ РЫНОК: Google + Яндекс (различия, которые важны)
-
-| Аспект | Google | Яндекс |
-|---|---|---|
-| Основной инструмент | Google Search Console | Яндекс Вебмастер |
-| Качество сайта | PageRank + тематичность (нет публичной метрики) | **ИКС** (Индекс качества сайта), публичный, обновляется примерно раз в месяц |
-| Регион | Гео по домену/контенту, Google Business Profile | **Регион в Вебмастере** (для «клиника в Москве» — критично) + Яндекс Бизнес |
-| Сниппеты | Rich results (Article, Organization, Breadcrumb на десктопе, Product…) | Сниппеты, быстрые ссылки, «Вопросы и ответы» (разметка + Вебмастер) |
-| Параметры URL | canonical + «Инструмент проверки URL» | `Clean-param` в robots.txt + canonical |
-| Роботы | Googlebot, Google-Extended (обучение ИИ) | YandexBot (+ YandexGPT-обучение не управляется отдельным токеном; следи за изменениями) |
-| ИИ-ответы | AI Overviews, AI Mode (учитываются в GSC, тип «Веб») | Яндекс Нейро (по отраслевым данным — опирается на верхние результаты; **проверить на актуальной версии**) |
-| Аналитика | GA4 | Яндекс Метрика (цели, вебвизор, карты скроллинга) |
-| Локальное SEO | Google Business Profile, отзывы | Яндекс Бизнес, Яндекс Карты, 2ГИС, отзывы с ответами |
-
-Правило: **делай так, чтобы работало в обоих**, но не жертвуй одним ради другого. Единая база: семантика,
-полезный контент, скорость, чистые URL, валидная разметка, сильные внутренние ссылки.
-
-Детали по инструментам: `references/measurement.md`.
-
-## 7. СТЕКИ (не изобретай заново)
-
-| Стек | Что делать | Где рецепт |
-|---|---|---|
-| **Laravel/Blade** | отдельный `<x-seo-meta>` + сервис `SeoService`, sitemap/robots роуты, JSON-LD из контроллера, кэш | `references/stack-recipes.md` |
-| **Bitrix/Aspro «Медицинский центр 3.0»** | SEO-поля инфоблоков, `.htaccess`/ЧПУ, `robots.txt` и `sitemap.xml` через настройки, канонические, 301 через `urlrewrite.php`, кэш | `references/stack-recipes.md` |
-| **React/Vite** | SSR/SSG (Astro/Next или prerender), react-helmet-аналог только если SSR, 404, CWV | `references/stack-recipes.md` |
-| **Статический HTML** | прямо в `<head>`, sitemap руками/скриптом, canonical, JSON-LD inline | `references/stack-recipes.md` |
-
-Ключевое правило любого стека: **SEO-данные генерируются на сервере и попадают в исходный HTML**. Всё, что
-появляется только после исполнения JS, поисковики видят нестабильно.
-
-## 8. ЧТО ЛЕЖИТ В СКИЛЛЕ
-
-```
-SKILL.md                          — этот файл: процесс, гейт, антипаттерны, шаблоны
-references/
-  technical-seo.md                — краулинг, индексация, canonical, редиректы, robots, sitemap,
-                                    пагинация, фасеты, дубли, hreflang, мобильный, CWV, JS/SPA,
-                                    лог-анализ, миграции URL
-  on-page.md                      — title/description/H1-H6, URL, контент, изображения, ссылки/анкоры,
-                                    OG/Twitter, крошки, микроразметка
-  structured-data.md              — JSON-LD шаблоны: Organization, WebSite, BreadcrumbList,
-                                    MedicalWebPage, MedicalClinic, Physician, FAQPage, Article,
-                                    LocalBusiness, Product, Service, Event + валидация
-  eeat-medical.md                 — YMYL/медицина: авторство, даты, источники, дисклеймеры, локальная
-                                    клиника (NAP, отзывы, лицензии), требования к контенту example.org
-  stack-recipes.md                — Laravel/Blade, Bitrix/Aspro, React/Vite, статика
-  content-seo.md                  — интент, кластеры, структура лендинга/статьи, перелинковка, CTA,
-                                    freshness, FAQ, микрокопирайт
-  audit-checklist.md              — 60+ проверок P0/P1/P2 + шаблон SEO-отчёта
-  measurement.md                  — GSC, Вебмастер, GA4/Метрика, KPI, UTM, мониторинг
-assets/
-  snippets/                       — готовые фрагменты: meta.blade.php; JSON-LD (организация, клиника,
-                                    MedicalWebPage, врач, FAQ, крошки); robots.txt; sitemap.xml
-                                    (sitemap-индекс) и sitemap-urlset-example.xml
-  README.md                       — как пользоваться сниппетами, статусы разметки в 2026, Битрикс
-  scripts/README.md               — контракт инструмента seo-audit.mjs (делает qa-toolsmith, task-5):
-                                    `node seo-audit.mjs <file|url> --out dir [--json]`,
-                                    выход seo-audit.json/md, severity critical/serious/minor
-```
-
-Инструмент `seo-audit.mjs` автоматизирует проверки из `references/audit-checklist.md` §13
-(«Автоматизируемые проверки»). Пока его нет — проверяй вручную по гейту §3.
-
-## 9. ОТЧЁТ (шаблон)
-
-```
-## SEO: <страница/задача>
-Интент: <информационный/коммерческий/локальный> · кластер: <главный запрос + 3–5 поддерживающих>
-Что сделано: <5–8 пунктов: title/desc, H1, canonical, JSON-LD, ссылки, alt, редиректы, sitemap>
-Проверено: <валидатор rich results: 0 ошибок; 200 + index; robots/sitemap; CWV; curl/view-source>
-Baseline: <если применимо — показы/клики/позиция/CTR до, дата>
-Риски: <что может просесть и почему; какие P1/P2 отложены>
-Что дальше: <следующие 1–3 шага: контент, перелинковка, ускорение, мониторинг>
-```
-
-## 10. ЕСЛИ ЗАДАЧА — «ПРОСТО СВЕРСТАТЬ / ПОПРАВИТЬ» (lite-режим)
-
-Не разводи процесс на час. Сделай минимум **SEO-по-умолчанию** за 10 минут:
-1. `title` + `description` + один `H1` по шаблону из §5.
-2. `canonical` + `robots:index,follow` + OG-теги.
-3. Семантика: `header/main/section/article/footer`, `lang="ru"`, заголовки по порядку.
-4. `alt` у всех картинок, `width/height`, lazy ниже фолда.
-5. Внутренние ссылки (2–4, осмысленные анкоры) + крошки, если страница не корневая.
-6. JSON-LD минимального типа (`WebPage`/`Article`/`Physician`/`MedicalClinic`).
-7. Прогнать мысленно гейт §3 и записать в отчёт, что проверено.
-
-Если задача — **аудит** существующего сайта: сначала `references/audit-checklist.md`, фиксируй P0/P1/P2,
-чини P0 (индексация, canonical, дубли, шаблоны title), только потом оптимизируй контент.
-
-## 11. МЕДИЦИНА = YMYL (краткая памятка)
-
-- Контент о здоровье влияет на жизнь человека → поисковики оценивают его строже (E-E-A-T), а ошибки бьют по
-  трафику и по репутации учреждения.
-- Каждая медицинская страница: **автор-врач**, **рецензент** (если есть), **дата публикации и обновления**,
-  **источники**, **дисклеймер**, **показания/противопоказания**, **когда обращаться к врачу**.
-- Не обещай результат («излечим», «гарантируем»), не запугивай, не подменяй очную консультацию.
-- Локальная клиника: единый NAP, лицензия, Яндекс Бизнес/Карты + 2ГИС + GBP, отзывы с ответами, фото реальных
-  мест (не стоки).
-- Подробно, с формулировками для example.org: `references/eeat-medical.md`.
+- [ ] **P0** `title` 50–60 и уникальный; `description` 140–160; один `H1`, H2–H6 по порядку.
+- [ ] **P0** 200, нет `noindex`/robots-запрета, `canonical` абсолютный, URL в `sitemap.xml`.
+- [ ] **P0** JSON-LD валиден и = контент; не сирота, 2–6 контекстных ссылок.
+- [ ] **P0** медицина: автор-врач, даты, источники, дисклеймер, лицензия.
+- [ ] **P1** URL читаемый (смена — 301), OG/`og:image` 1200×630, крошки + `BreadcrumbList`, `alt`/размеры/lazy (LCP — без lazy)/WebP, CWV ≤2,5 с/≤200 мс/≤0,1 или план с датой.
+- [ ] **P2** `lang`/charset/viewport/favicon; нет битых ссылок и цепочек.

package/skills/seo/references/antipatterns.md

@@ -0,0 +1,66 @@
+> Часть навыка seo. ≈2 050 токенов. Читать, когда: сомневаешься в приёме («так делают все»), защищаешь решение перед заказчиком или ищешь причину просадки трафика и доверия.
+
+# Антипаттерны SEO: что мгновенно убивает позиции и доверие
+
+> Эти приёмы не «слабый эффект», а риск фильтра, санкций и репутационной потери — особенно в медицине (YMYL).
+> Нашёл такое в коде или тексте — фиксируй в отчёте как риск и убирай, даже если «работало годами».
+> Детали по разделам: `technical-seo.md` §14, `content-seo.md` §12, `structured-data.md` §11, `eeat-medical.md` §5.
+
+## 1. Контент и переоптимизация
+
+- keyword stuffing — ключи в текст, alt и заголовки «для плотности».
+- текст «для роботов», а не для людей: перечисление запросов вместо ответа.
+- скрытый текст и скрытые ссылки (`display:none`, белым по белому, `text-indent`) — санкционный риск.
+- двери (doorway pages) — пустые страницы-прокладки под каждый запрос.
+- одинаковый текст на N страниц (шаблонные описания услуг, копии карточек врачей).
+- каннибализация запросов: две страницы под один интент конкурируют и обе проигрывают.
+- заголовки-обманки («Вы не поверите»), кликбейт не по содержанию.
+- «гарантируем излечение» и любые обещания результата в медицине — и юридический, и репутационный риск.
+- контент без автора, без даты публикации и обновления.
+- копипаст с других медсайтов без переработки в факты и местную специфику.
+- автогенерация массы однотипных ИИ-страниц без редактуры (риск «scaled content abuse»).
+
+## 2. Технические
+
+- `noindex` на деньгах/услугах (часто «после правок безопасности»).
+- `canonical` на чужой URL, на главную со всех страниц или с параметрами (`?utm=`, `?sort=`).
+- редирект-цепочки (`A → B → C`), 302 вместо 301 для постоянных переездов.
+- дубли www/без-www, http/https, слэш/без слэша — без 301.
+- «мягкие 404»: 200 на несуществующей странице, редирект на главную вместо 404.
+- закрытые в `robots.txt` CSS/JS/картинки — робот не отрисует страницу.
+- sitemap с 404, редиректами и `noindex`; `lastmod` = «сегодня» у всех URL.
+- тысячи мусорных URL в индексе (фасеты, сортировки, `print`, поиск по сайту).
+- `title` одинаковый на всех страницах; `H1` = логотип или отсутствует.
+- контент и мета только через JS, без SSR/SSG/prerender.
+- блокировка обхода ради «экономии краулинга» — робот не увидит `noindex` и canonical.
+- lazy-load на LCP-изображении; CLS из-за шрифтов и баннеров без размеров.
+
+## 3. Медицина и доверие
+
+- отзывы-выдумки, накрутка рейтинга, удаление негатива.
+- `aggregateRating` на собственные отзывы (self-serving reviews в rich results не показываются, накрутка = риск).
+- фото-стоки врачей вместо реальных; выдуманные стаж, награды, публикации.
+- дисклеймер «мы не отвечаем» / его отсутствие; назначения «по интернету».
+- противоречивые цены: в тексте ≠ в прайсе.
+- разные телефоны/адреса на сайте и в Яндекс Бизнесе, 2ГИС, GBP — ломает локальную выдачу и доверие.
+- отсутствие «когда срочно к врачу» на симптомных статьях.
+
+## 4. ИИ-эра
+
+- верить в «секретный файл `llms.txt`»: Google официально заявил, что такие файлы ему не нужны и на ранжирование
+  не влияют (`content-seo.md` §10).
+- генерировать сотни ИИ-статей без редактуры и факт-чека (риск «scaled content abuse»).
+- прятать контент от ИИ-сниппетов (`nosnippet`, блокировка `Google-Extended`) и одновременно ждать трафика
+  из ИИ-ответов — это взаимоисключающие решения, выбирай осознанно.
+- «оптимизация под ИИ» вместо базовой индексации, полезного контента и разметки сущностей.
+
+## 5. Что делать вместо
+
+| Вместо | Делай |
+|---|---|
+| ключи в текст | ответ на интент в первых 100–150 словах + структура H2/списки/таблицы |
+| страница-прокладка под запрос | одна сильная страница под кластер + перелинковка |
+| скрыть от поиска | `noindex,follow` + причина в отчёте |
+| скрыть от ИИ | решить: нужен трафик из ИИ или закрытый контент; не «и то, и то» |
+| накрутить рейтинг | реальные отзывы с площадок + ответы администрации |
+| обещать излечение | «врач подберёт схему по результатам обследования» |

package/skills/seo/references/audit-checklist.md

@@ -1,3 +1,5 @@
+> Часть навыка seo. ≈7 900 токенов. Читать, когда: аудит сайта или финальная приёмка — 107 проверок P0/P1/P2, шаблоны отчёта, карта автотестов `seo-audit.mjs`.
+
 # Чек-лист SEO-аудита (P0/P1/P2) + шаблон отчёта
 
 > 107 проверок по 12 областям. Используй для аудита существующего сайта и как «definition of done» для новых
@@ -284,6 +286,18 @@
 <смена URL без редиректов, потеря трафика, YMYL-риски>
 ```
 
+### Короткий отчёт по странице/задаче (не аудит)
+
+```markdown
+## SEO: <страница/задача>
+Интент: <информационный/коммерческий/локальный> · кластер: <главный запрос + 3–5 поддерживающих>
+Что сделано: <5–8 пунктов: title/desc, H1, canonical, JSON-LD, ссылки, alt, редиректы, sitemap>
+Проверено: <валидатор: 0 ошибок; 200 + index; robots/sitemap; CWV; curl/view-source>
+Baseline: <если применимо — показы/клики/позиция/CTR до, дата>
+Риски: <что может просесть и почему; какие P1/P2 отложены>
+Что дальше: <1–3 шага: контент, перелинковка, ускорение, мониторинг>
+```
+
 ## 15. Как приоритизировать (если P0 много)
 
 1. **Индексация** (IDX-01…04, 07) — без неё остальное бессмысленно.