# docs-seo

Проводит технический SEO-аудит сайтов документации: ищет дубли версий, настраивает канонические ссылки и проверяет индексацию.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 10000 установок · ★ 5
- Автор: Samuel Berthe
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/samber/developer-relations-skills/tree/HEAD/skills/docs-seo/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/docs-seo

## Что делает

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

Сначала агент проводит опрос по кодовой базе и платформе хостинга, сохраняя контекст в файл `devrel-context.md`. Если у разработчика нет доступа к конфигурации генератора или сборке, скилл сразу прекратит работу. Почти все исправления здесь внедряются через шаблоны и конфиг, поэтому ручные правки отдельных страниц не имеют смысла.

Для сбора данных запускается скрипт обхода карты сайта `scripts/docs-seo-crawl.py`. Он выгружает директивы robots, канонические теги, первые заголовки `h1`, число внутренних ссылок и пустые страницы.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-relations-skills --skill docs-seo -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/docs-seo/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/docs-seo/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-relations-skills --skill docs-seo -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/docs-seo/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-relations-skills --skill docs-seo -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/docs-seo/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install samber/developer-relations-skills docs-seo
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/docs-seo/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-relations-skills --skill docs-seo -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/samber/developer-relations-skills --path skills/docs-seo
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/docs-seo/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-relations-skills --skill docs-seo -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/samber/developer-relations-skills/tree/HEAD/skills/docs-seo/SKILL.md

## Когда брать
- найти старые версии документации, вытесняющие актуальные в поиске
- исправить дубли страниц и конфликты канонических ссылок
- закрыть тестовые ветки и превью-стенды от индексации
- проверить размер и структуру карты сайта

## Примеры запросов агенту
- Проведи технический SEO-аудит сайта нашей документации
- В поиске ранжируется первая версия вместо третьей, проверь канонические ссылки
- Проверь sitemap и индексацию сгенерированных страниц справочника API

## Похожие
- [seo-hreflang](https://affpapa.org/nevibecode/skills/seo-hreflang.md) — скилл · 6800 установок
- [seo-audit](https://affpapa.org/nevibecode/skills/coreyhaines31-seo-audit.md) — скилл · 237600 установок
- [seo-sitemap](https://affpapa.org/nevibecode/skills/seo-sitemap.md) — скилл · 7200 установок
- [nuxt-seo](https://affpapa.org/nevibecode/skills/nuxt-seo.md) — скилл · 3100 установок
- [seo-local-business](https://affpapa.org/nevibecode/skills/seo-local-business.md) — скилл · 1800 установок
- [seo-auditing](https://affpapa.org/nevibecode/skills/seo-auditing.md) — скилл · 456 установок

Из того же набора: [samber/developer-relations-skills](https://affpapa.org/nevibecode/by/samber/developer-relations-skills.md) — 54 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md