Skip to main content
skill CX Codex

audit-library-health — Claude Code skill: library health check

audit-library-health — a skill for diagnosing a skills library: validates structure, finds stale elements, checks documentation sync. Run before publishing or updating.

MIT 170 installs ★ 1,161 updated 2026-09-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a claude-code
Open on GitHub

What audit-library-health does

Audits a library in four stages: validates catalog structure and frontmatter, runs diagnostics on installed skills, identifies elements ready for refresh, and compares generated docs against actual state. Each step outputs structured JSON for easy automation.

Includes four commands: validate checks catalog integrity and required fields; doctor --format json diagnoses installations; check --format json scans for stale skills via network requests (can be slow on unreachable repos); build-docs --dry-run reports whether docs are in sync, then regenerates if needed. Before pushing to a public repo, both validate and doctor must pass without errors.

Provides a checklist: all fields populated, folders consistent, skill count in skills.json matches reality. The guardrail on --dry-run before build-docs prevents accidental mutations.

What it helps with

  • verify library structure consistency before publishing
  • locate skills with missing required fields
  • synchronize generated documentation with the current catalog
  • identify stale skills that need updates
  • diagnose broken installations in a local library

Example prompts for the agent

  • Check the health of my skills library before pushing it
  • Run audit-library-health and tell me if docs are in sync
  • Find all skills with missing fields using validate

How to install audit-library-health

1Skills CLI (Vercel)

npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/audit-library-health/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about audit-library-health

How do I install audit-library-health in Claude Code?

Run npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a claude-code, then open ~/.claude/skills/audit-library-health/SKILL.md.

What does audit-library-health do?

It scans your library for structural errors, outdated skills, documentation drift, and installation issues. It validates, diagnoses, and prepares your library for release.

Why is build-docs slow and how do I speed it up?

The check command makes network calls to verify upstream repos. Use --dry-run first to avoid regenerating docs unnecessarily, and --fields to limit output on large catalogs.

Source text

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set15

The whole set →
ask-questions-if-underspecified The ask-questions-if-underspecified skill makes the agent ask 1–5 clarifying questions before it starts work, so you don't get the wrong thing built. Invoked manually. CX Codex +1 383installs browse-and-evaluate The browse-and-evaluate skill helps you find, compare, and inspect catalog skills before adding them. Use it when catalog output needs to stay focused. CX Codex +1 177installs review-a-skill review-a-skill reviews a skill before it enters a library by checking metadata, structure, safety, and dependencies. Use it when the choice is keep, curate, or remove. CX Codex +1 177installs build-workspace-docs build-workspace-docs keeps README.md and WORK_AREAS.md aligned with a skills catalog. Run it after catalog changes or before committing workspace updates. CX Codex +1 172installs update-installed-skills update-installed-skills syncs previously installed agent skills to their upstream versions. Helps you inspect changes safely with dry-run flags before overwriting local setups. CX Codex +1 168installs share-a-library share-a-library — a skill that automates publishing a finished local library to GitHub and generates an install command for your teammates. CX Codex +1 161installs install-from-remote-library install-from-remote-library guides safe skill installs from shared repos. Inspects targets via --list and previews every action with a dry-run flag. CX Codex +1 161installs curate-a-team-library curate-a-team-library — a skill for Claude Code, Codex, Cursor and other agents that walks an agent through building a team skills library: mapping shelves, adding entries with curator metadata, assembling a starter pack. CX Codex +1 160installs

Project sponsors

Companies that keep this analytics open