Back to skills
SKILL.md
Docs Audit
ASecurityRead-only аудит дрейфа docs↔код — битые ссылки, устаревшие примеры/счётчики/версии, несинхронные языковые версии (роль docs). Use чтобы проверить, не врёт ли документация после изменений кода.
- 2 stars
- 0 votes
- 0 copies
- 0 views
- Added September 11, 2026
Works with
Security analysis
100/100npx -y skills add Vitammiin/agent-vorcl-flow --skill docs-audit --agent claude-codeAre you the author of Docs Audit?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/vitammiin-docs-audit)---
name: docs-audit
description: Read-only аудит дрейфа docs↔код — битые ссылки, устаревшие примеры/счётчики/версии, несинхронные языковые версии (роль docs). Use чтобы проверить, не врёт ли документация после изменений кода.
---
# Задача: аудит дрейфа документации
Найди дрейф доков относительно кода (**read-only**, см. `$technical-writing`).
1. Корпус: `README*`, `docs/**`, `ARCHITECTURE.md`, `CONTRIBUTING.md`, `CHANGELOG.md` (все `*.md`, минус `node_modules`).
2. Ссылки: относительные — существование файлов/якорей; внешние — хотя бы формат.
3. Примеры: команды — против `scripts`/бинарей (`npm run <x>` существует?); флаги/env/эндпоинты — грепом по коду; фрагменты кода — с текущими сигнатурами.
4. Счётчики и версии: «N модулей» — пересчётом файлов; версии — против `package.json`/манифеста/тегов; Node — против `engines`.
5. API-факты — против OpenAPI-спеки (спеки нет — отдельная находка, предложи `$swagger-audit`).
6. Языковой паритет (`README.md` vs `README.ru.md`): набор секций, факты/версии, идентичность кодовых блоков.
**Ничего не правь.** Формат находки: `file:line` — заявлено — в реальности (доказательство: греп/вывод) — severity (`critical>high>medium>low`; врущий quickstart = high+). По значимым — `add_task`. В конце — сводка дрейфа по документам (чисто/дрейф/сильно устарел).
Attribution
Comments
Loading comments…