{"id":"a8d39faf-46db-4743-957f-4e56a5e596af","shortId":"y7FTNE","kind":"skill","title":"audit-library-health","tagline":"Use when checking the overall health of a skills library. Run doctor, validate, check for stale skills, and verify generated docs are in sync.","description":"# Audit Library Health\n\n## Goal\n\nVerify that a skills library is consistent, up-to-date, and ready to share or install from.\n\n## Guardrails\n\n- Always use `--format json` for structured output when automating health checks.\n- Always use `--dry-run` before running `build-docs` to check if docs are already in sync.\n- Never push a library to a shared repo without passing `validate` and `doctor` first.\n- Use `--fields` to limit output when inspecting large catalogs.\n\n## Workflow\n\n1. Run the validation script to check catalog integrity.\n\n```bash\nnpx ai-agent-skills validate\n```\n\nThis checks: required fields, folder consistency, frontmatter validity, collection integrity, and generated doc sync.\n\n2. Run doctor to check installed skills health.\n\n```bash\nnpx ai-agent-skills doctor --format json\n```\n\n3. Check for skills that may need updates.\n\n```bash\nnpx ai-agent-skills check --format json\n```\n\n4. Verify generated docs are in sync.\n\n```bash\nnpx ai-agent-skills build-docs --dry-run --format json\n```\n\nIf `currentlyInSync` is false, regenerate:\n\n```bash\nnpx ai-agent-skills build-docs\n```\n\n5. Review the curation queue for skills needing attention.\n\n```bash\nnpx ai-agent-skills curate review --format json\n```\n\n## Health Checklist\n\n- [ ] `validate` passes with no errors\n- [ ] `doctor` reports no broken installs\n- [ ] `build-docs --dry-run` shows docs are in sync\n- [ ] No skills with empty `whyHere` fields\n- [ ] All house skills have matching folders in `skills/`\n- [ ] `skills.json` total matches actual skill count\n\n## Gotchas\n\n- `validate` and `doctor` are read-only — they never mutate the library.\n- `check` makes network requests to verify upstream sources. It may be slow or timeout on unreachable repos.\n- The `curate review` queue is derived from missing fields and stale verification dates — it is a heuristic, not a mandate.","tags":["audit","library","health","agent","skills","moizibnyousaf","agent-skills","claude-code","cli","codex","cursor","developer-tools"],"capabilities":["skill","source-moizibnyousaf","skill-audit-library-health","topic-agent-skills","topic-claude-code","topic-cli","topic-codex","topic-cursor","topic-developer-tools","topic-productivity"],"categories":["Ai-Agent-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/MoizIbnYousaf/Ai-Agent-Skills/audit-library-health","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add MoizIbnYousaf/Ai-Agent-Skills","source_repo":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 1044 github stars · SKILL.md body (1,842 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T18:52:54.122Z","embedding":null,"createdAt":"2026-04-18T21:56:07.881Z","updatedAt":"2026-05-02T18:52:54.122Z","lastSeenAt":"2026-05-02T18:52:54.122Z","tsv":"'1':105 '2':135 '3':152 '4':169 '5':204 'actual':263 'agent':118,147,164,180,199,217 'ai':117,146,163,179,198,216 'ai-agent-skil':116,145,162,178,197,215 'alreadi':78 'alway':52,63 'attent':212 'audit':2,29 'audit-library-health':1 'autom':60 'bash':114,143,160,176,195,213 'broken':233 'build':71,183,202,236 'build-doc':70,182,201,235 'catalog':103,112 'check':7,18,62,74,111,122,139,153,166,279 'checklist':224 'collect':129 'consist':39,126 'count':265 'curat':207,219,297 'currentlyinsync':191 'date':43,308 'deriv':301 'doc':25,72,76,133,172,184,203,237,242 'doctor':16,93,137,149,230,269 'dri':66,186,239 'dry-run':65,185,238 'empti':249 'error':229 'fals':193 'field':96,124,251,304 'first':94 'folder':125,257 'format':54,150,167,188,221 'frontmatt':127 'generat':24,132,171 'goal':32 'gotcha':266 'guardrail':51 'health':4,10,31,61,142,223 'heurist':312 'hous':253 'inspect':101 'instal':49,140,234 'integr':113,130 'json':55,151,168,189,222 'larg':102 'librari':3,14,30,37,84,278 'limit':98 'make':280 'mandat':315 'match':256,262 'may':157,288 'miss':303 'mutat':276 'need':158,211 'network':281 'never':81,275 'npx':115,144,161,177,196,214 'output':58,99 'overal':9 'pass':90,226 'push':82 'queue':208,299 'read':272 'read-on':271 'readi':45 'regener':194 'repo':88,295 'report':231 'request':282 'requir':123 'review':205,220,298 'run':15,67,69,106,136,187,240 'script':109 'share':47,87 'show':241 'skill':13,21,36,119,141,148,155,165,181,200,210,218,247,254,259,264 'skill-audit-library-health' 'skills.json':260 'slow':290 'sourc':286 'source-moizibnyousaf' 'stale':20,306 'structur':57 'sync':28,80,134,175,245 'timeout':292 'topic-agent-skills' 'topic-claude-code' 'topic-cli' 'topic-codex' 'topic-cursor' 'topic-developer-tools' 'topic-productivity' 'total':261 'unreach':294 'up-to-d':40 'updat':159 'upstream':285 'use':5,53,64,95 'valid':17,91,108,120,128,225,267 'verif':307 'verifi':23,33,170,284 'whyher':250 'without':89 'workflow':104","prices":[{"id":"9da59f56-0897-4652-95cd-f4a3a65d5afb","listingId":"a8d39faf-46db-4743-957f-4e56a5e596af","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"MoizIbnYousaf","category":"Ai-Agent-Skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:56:07.881Z"}],"sources":[{"listingId":"a8d39faf-46db-4743-957f-4e56a5e596af","source":"github","sourceId":"MoizIbnYousaf/Ai-Agent-Skills/audit-library-health","sourceUrl":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills/tree/main/skills/audit-library-health","isPrimary":false,"firstSeenAt":"2026-04-18T21:56:07.881Z","lastSeenAt":"2026-05-02T18:52:54.122Z"}],"details":{"listingId":"a8d39faf-46db-4743-957f-4e56a5e596af","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MoizIbnYousaf","slug":"audit-library-health","github":{"repo":"MoizIbnYousaf/Ai-Agent-Skills","stars":1044,"topics":["agent-skills","claude-code","cli","codex","cursor","developer-tools","productivity"],"license":"mit","html_url":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills","pushed_at":"2026-04-13T19:04:12Z","description":"my curated agent skills library ","skill_md_sha":"5454cd375d726cbe86be9783bf878faf44b8aa94","skill_md_path":"skills/audit-library-health/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills/tree/main/skills/audit-library-health"},"layout":"multi","source":"github","category":"Ai-Agent-Skills","frontmatter":{"name":"audit-library-health","description":"Use when checking the overall health of a skills library. Run doctor, validate, check for stale skills, and verify generated docs are in sync."},"skills_sh_url":"https://skills.sh/MoizIbnYousaf/Ai-Agent-Skills/audit-library-health"},"updatedAt":"2026-05-02T18:52:54.122Z"}}