Documentation
README
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 jsonfor structured output when automating health checks. - Always use
--dry-runbefore runningbuild-docsto check if docs are already in sync. - Never push a library to a shared repo without passing
validateanddoctorfirst. - Use
--fieldsto limit output when inspecting large catalogs.
Workflow
- Run the validation script to check catalog integrity.
npx ai-agent-skills validate
This checks: required fields, folder consistency, frontmatter validity, collection integrity, and generated doc sync.
- Run doctor to check installed skills health.
npx ai-agent-skills doctor --format json
This is the opening of the README. Read the full README on GitHub.