OpenParable
Skip to content
← Back to skills

Audit Library Health

Testing & Quality
audit-library-health

Audit 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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 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.
npx ai-agent-skills validate

This checks: required fields, folder consistency, frontmatter validity, collection integrity, and generated doc sync.

  1. Run doctor to check installed skills health.
npx ai-agent-skills doctor --format json
  1. Check for skills that may need updates.
npx ai-agent-skills check --format json
  1. 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
  1. Review the curation queue for skills needing attention.
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.