# claude-docs-validate

Скилл проверяет локальную копию документации Claude: свежесть, битые ссылки, состояние кэша. Пригодится, когда нужно понять, не устарели ли справки в ~/.claude-code-docs/.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 55
- Автор: costiash
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/costiash/claude-code-docs/tree/HEAD/plugin/skills/claude-docs-validate/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/claude-docs-validate

## Что делает

Скилл работает с локальным клоном документации в `~/.claude-code-docs/`. Сначала он смотрит, есть ли файл `paths_manifest.json`. Если его нет, значит плагин не установлен или документация не склонирована — скилл подскажет команды установки.

Дальше проверяется свежесть по двум сигналам: когда собрали манифест и когда клон последний раз обновлялся через git. Если манифест старше примерно суток, его обычно обновляет SessionStart-хук на следующей сессии. Вручную это делается через `git fetch origin main` и `git reset --hard origin/main` в каталоге документации. Затем скилл смотрит статус кэша скриптом `fetch-docs.sh status` — сколько страниц в манифесте, сколько закэшировано, сколько в ожидании.

Отдельный шаг — валидация URL скриптом `validate-paths.sh`. Есть быстрый режим с флагом `--quick` и полный скан, который занимает 1-2 минуты. Скрипт берёт адреса прямо из манифеста и выдаёт сводку: доступные, битые, с таймаутом. Если битые ссылки не пропадают после `git pull`, страница могла переехать — об этом стоит написать в issues репозитория. Для статистики есть `jq` по манифесту: общее число страниц и разбивка по категориям.

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add costiash/claude-code-docs --skill claude-docs-validate -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add costiash/claude-code-docs --skill claude-docs-validate -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install costiash/claude-code-docs claude-docs-validate
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add costiash/claude-code-docs --skill claude-docs-validate -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/costiash/claude-code-docs --path plugin/skills/claude-docs-validate
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add costiash/claude-code-docs --skill claude-docs-validate -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- Проверь, актуальна ли моя локальная документация Claude
- Найди битые ссылки в документации
- Покажи статистику по страницам документации

## Похожие
- [grill-with-docs](https://affpapa.org/nevibecode/skills/grill-with-docs.md) — скилл · 1219756 установок
- [skill-creator](https://affpapa.org/nevibecode/skills/skill-creator.md) — скилл · 414180 установок
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [handoff](https://affpapa.org/nevibecode/skills/handoff.md) — скилл · 1038491 установка
- [triage](https://affpapa.org/nevibecode/skills/triage.md) — скилл · 990453 установки
- [domain-modeling](https://affpapa.org/nevibecode/skills/domain-modeling.md) — скилл · 876391 установка

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

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