Audit Library Health
Testing & Qualityaudit-library-healthAudit Library Health is an Agent Skill for testing & quality published in the MoizIbnYousaf/Ai-Agent-Skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when checking the overall health of a skills library. Run doctor, validate, check for stale skills, and verify generated docs are in sync.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/MoizIbnYousaf/Ai-Agent-Skills/blob/HEAD/skills/audit-library-health/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/audit-library-health, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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
- Check for skills that may need updates.
npx ai-agent-skills check --format json
- Verify generated docs are in sync.
npx ai-agent-skills build-docs --dry-run --format json
If currentlyInSync is false, regenerate:
npx ai-agent-skills build-docs
- Review the curation queue for skills needing attention.
npx ai-agent-skills curate review --format json
Health Checklist
-
validatepasses with no errors -
doctorreports no broken installs -
build-docs --dry-runshows docs are in sync - No skills with empty
whyHerefields - All house skills have matching folders in
skills/ -
skills.jsontotal matches actual skill count
Gotchas
validateanddoctorare read-only — they never mutate the library.checkmakes network requests to verify upstream sources. It may be slow or timeout on unreachable repos.- The
curate reviewqueue is derived from missing fields and stale verification dates — it is a heuristic, not a mandate.