Index of every page on this site: llms.txt
All skills
moizibnyousaf avatar

/audit-library-health

@6d95c78
Run it yourself

Use when checking the overall health of a skills library. Run doctor, validate, check for stale skills, and verify generated docs are in sync.

Use this Skill: https://skilld.dev/gh/moizibnyousaf/ai-agent-skills/audit-library-health

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈41 tokens for metadata: the name and description. ≈462 when used: this file.

Description uses 2.1% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈165 characters, or 2.1%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    This skill provides a workflow for auditing the health of a skills library using the ai-agent-skills utility. It includes standard validation, health checks, and documentation syncing steps without any suspicious or malicious patterns.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

Signed by skilld at 6d95c78. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 7 months ago
category
workflow
version
4.1.0

README badge

README badge for moizibnyousaf/ai-agent-skills/audit-library-health