audit-library-health

1# Audit Library Health
2 
3## Goal
4 
5Verify that a skills library is consistent, up-to-date, and ready to share or install from.
6 
7## Guardrails
8 
9- Always use `--format json` for structured output when automating health checks.
10- Always use `--dry-run` before running `build-docs` to check if docs are already in sync.
11- Never push a library to a shared repo without passing `validate` and `doctor` first.
12- Use `--fields` to limit output when inspecting large catalogs.
13 
14## Workflow
15 
161. Run the validation script to check catalog integrity.
17 
18```bash
19npx ai-agent-skills validate
20```
21 
22This checks: required fields, folder consistency, frontmatter validity, collection integrity, and generated doc sync.
23 
242. Run doctor to check installed skills health.
25 
26```bash
27npx ai-agent-skills doctor --format json
28```
29 
303. Check for skills that may need updates.
31 
32```bash
33npx ai-agent-skills check --format json
34```
35 
364. Verify generated docs are in sync.
37 
38```bash
39npx ai-agent-skills build-docs --dry-run --format json
40```
41 
42If `currentlyInSync` is false, regenerate:
43 
44```bash
45npx ai-agent-skills build-docs
46```
47 
485. Review the curation queue for skills needing attention.
49 
50```bash
51npx ai-agent-skills curate review --format json
52```
53 
54## Health Checklist
55 
56- [ ] `validate` passes with no errors
57- [ ] `doctor` reports no broken installs
58- [ ] `build-docs --dry-run` shows docs are in sync
59- [ ] No skills with empty `whyHere` fields
60- [ ] All house skills have matching folders in `skills/`
61…