К основному содержанию
скилл CX Codex

audit-library-health — скилл для Claude Code

Скилл audit-library-health для комплексной диагностики библиотеки скиллов: валидация структуры, поиск устаревших элементов, проверка синхронизации документации. Запускайте перед публикацией или обновлением.

MIT 170 установок ★ 1 161 обновлён 2026-09-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/audit-library-health/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/audit-library-health/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
help bitwize-music-studio Скилл help для Claude Code показывает каталог команд, рабочих процессов и быстрые советы; вызывай его, чтобы найти команду или узнать назначение инструмента. CX Codex +1 253установок documentation-engineer VoltAgent Субагент documentation-engineer для технической документации, которая не отстаёт от реального кода и рабочих процессов. Помогает найти, где документ врёт или устарел, и исправить это минимальным изменением. CX Codex ★ 6 505звёзд репо add-skill softaworks Команда add-skill для копирования скилла в проект с проверкой названия и автогенерацией README. Сэкономит время на валидацию и документацию. CX Codex +1 ★ 2 707звёзд репо marketplace-health-check daymade Скилл marketplace-health-check прогоняет параллельный аудит репозитория скиллов: безопасность скриптов, документация, PII, открытые PR и issues, целостность манифеста. CX Codex +1 452установок loop-library Forward-Future Скилл loop-library для Claude Code — устаревший алиас Loopy: находит повторяющиеся задачи и подбирает или проектирует циклы с точками выхода. CX Codex +1 2 400установок production-code-audit sickn33 Скилл production-code-audit для комплексной проверки кода на уязвимости, ошибки и узкие места перед развёртыванием. Находит конкретные проблемы, предлагает исправления и проверяет результаты. CX Codex +1 1 300установок

Из того же набора15

Весь набор →
ask-questions-if-underspecified Скилл ask-questions-if-underspecified заставляет агента задать 1–5 уточняющих вопросов до начала работы, чтобы не переделывать её потом. Вызывается вручную. CX Codex +1 383установок browse-and-evaluate Скилл browse-and-evaluate помогает найти, сравнить и проверить скиллы каталога до установки. Подходит, когда нужно просмотреть варианты без лишнего вывода. CX Codex +1 177установок review-a-skill Скилл review-a-skill для Claude Code проверяет скилл перед добавлением в библиотеку: метаданные, структуру, безопасность и зависимости. Помогает решить, оставить его, доработать или удалить. CX Codex +1 177установок build-workspace-docs Скилл build-workspace-docs синхронизирует README.md и WORK_AREAS.md с каталогом скиллов. Нужен после изменений в библиотеке или перед коммитом. CX Codex +1 172установок update-installed-skills Скилл update-installed-skills для Claude Code синхронизирует установленные скиллы с новыми версиями в репозиториях. Перед синхронизацией проверяет обновления через dry-run; локальные правки нужно сохранить отдельно. CX Codex +1 168установок share-a-library Скилл share-a-library автоматизирует публикацию готовой локальной библиотеки на GitHub и генерирует команду установки для товарищей по команде. CX Codex +1 161установок install-from-remote-library Скилл install-from-remote-library помогает безопасно ставить скиллы из общих репозиториев. Сначала изучает состав каталога и запускает тестовый прогон через --dry-run. CX Codex +1 161установок curate-a-team-library Скилл curate-a-team-library для Claude Code, Codex, Cursor и других агентов, который ведёт агента через построение командной библиотеки скиллов: распределение по полкам, добавление с метаданными, сборка стартового набора. CX Codex +1 160установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой