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
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/audit-library-health/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/audit-library-health/
1Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a codex2Manually: put the files in place
.agents/skills/audit-library-health/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a cursor2Manually: put the files in place
.cursor/skills/audit-library-health/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MoizIbnYousaf/ai-agent-skills skills/audit-library-health2Manually: put the files in place
.github/skills/audit-library-health/SKILL.md1Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a gemini-cli2Platform CLI
gemini skills install https://github.com/MoizIbnYousaf/ai-agent-skills --path skills/audit-library-healthManually: put the files in place
.devin/skills/audit-library-health/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill audit-library-health -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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