audit-library-health — скилл для Claude Code
Скилл audit-library-health для комплексной диагностики библиотеки скиллов: валидация структуры, поиск устаревших элементов, проверка синхронизации документации. Запускайте перед публикацией или обновлением.
MIT 170 установок ★ 1 161 обновлён 2026-09-21
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a claude-codeЧто делает audit-library-health
Проходит по библиотеке в четыре этапа: валидирует структуру каталога и frontmatter, запускает doctor для проверки установленных скиллов, ищет элементы, готовые к обновлению, и сравнивает сгенерированную документацию с актуальным состоянием. Каждый шаг выводит структурированный JSON, что упрощает автоматизацию.
Внутри четыре команды: validate проверяет целостность каталога и обязательные поля; doctor --format json диагностирует установки; check --format json ищет стаивающие скиллы через сетевые запросы (может быть медленным на недоступных репозиториях); build-docs --dry-run показывает, синхронна ли документация, и при рассинхронизации регенерирует её. Перед push в публичный репозиторий нужно пройти validate и doctor без ошибок.
Скилл даёт чек-лист: все поля заполнены, папки консистентны, счётчик в skills.json совпадает с реальным числом скиллов. Guardrail на --dry-run перед build-docs убережёт от случайных изменений.
Какие задачи решает
- проверить консистентность структуры библиотеки перед публикацией
- найти скиллы с пропущенными обязательными полями
- синхронизировать сгенерированную документацию с текущим каталогом
- выявить устаревшие скиллы, требующие обновления
- диагностировать сломанные установки в локальной библиотеке
Примеры запросов агенту
- Проверь здоровье моей библиотеки скиллов перед пушем
- Запусти audit-library-health и покажи, синхронна ли документация
- Найди в библиотеке скиллы с пропущенными полями через validate
Как установить audit-library-health
1Через Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a claude-code2Вручную: положить файлы
~/.claude/skills/audit-library-health/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/audit-library-health/
1Через Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a codex2Вручную: положить файлы
.agents/skills/audit-library-health/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a cursor2Вручную: положить файлы
.cursor/skills/audit-library-health/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install MoizIbnYousaf/ai-agent-skills skills/audit-library-health2Вручную: положить файлы
.github/skills/audit-library-health/SKILL.md1Через Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a gemini-cli2Командой платформы
gemini skills install https://github.com/MoizIbnYousaf/ai-agent-skills --path skills/audit-library-healthВручную: положить файлы
.devin/skills/audit-library-health/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об audit-library-health
Как установить audit-library-health в Claude Code?
Запусти npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a claude-code, затем открой ~/.claude/skills/audit-library-health/SKILL.md.
Что делает audit-library-health?
Проверяет библиотеку на ошибки структуры, устаревшие скиллы, рассинхронизацию документации и проблемы установок. Выполняет валидацию, диагностику и подготовку к публикации.
Почему build-docs медленный и как его ускорить?
Команда check делает сетевые запросы к репозиториям для проверки источников. Используй --dry-run сначала, чтобы не перегенерировать документацию без нужды, а --fields для ограничения вывода на больших каталогах.
Исходный текст
SKILL.md · MIT
--- name: audit-library-health description: Use when checking the overall health of a skills library. Run doctor, validate, check for stale skills, and verify generated docs are in sync. category: workflow version: 4.1.0 --- # Audit Library Health ## Goal Verify that a skills library is consistent, up-to-date, and ready to share or install from. ## Guardrails - Always use `--format json` for structured output when automating health checks. - Always use `--dry-run` before running `build-docs` to check if docs are already in sync. - Never push a library to a shared repo without passing `validate` and `doctor` first. - Use `--fields` to limit output when inspecting large catalogs. ## Workflow 1. Run the validation script to check catalog integrity. ```bash npx ai-agent-skills validate ``` This checks: required fields, folder consistency, frontmatter validity, collection integrity, and generated doc sync. 2. Run doctor to check installed skills health. ```bash npx ai-agent-skills doctor --format json ``` 3. Check for skills that may need updates. ```bash npx ai-agent-skills check --format json ``` 4. Verify generated docs are in sync. ```bash npx ai-agent-skills build-docs --dry-run --format json ``` If `currentlyInSync` is false, regenerate: ```bash npx ai-agent-skills build-docs ``` 5. Review the curation queue for skills needing attention. ```bash npx ai-agent-skills curate review --format json ``` ## Health Checklist - [ ] `validate` passes with no errors - [ ] `doctor` reports no broken installs - [ ] `build-docs --dry-run` shows docs are in sync - [ ] No skills with empty `whyHere` fields - [ ] All house skills have matching folders in `skills/` - [ ] `skills.json` total matches actual skill count ## Gotchas - `validate` and `doctor` are read-only — they never mutate the library. - `check` makes network requests to verify upstream sources. It may be slow or timeout on unreachable repos. - The `curate review` queue is derived from missing fields and stale verification dates — it is a heuristic, not a mandate.
© MoizIbnYousaf · MIT · MoizIbnYousaf/ai-agent-skills