audit-library-health
Use when checking the overall health of a skills library. Run doctor, validate, check for stale skills, and verify generated docs are in sync.
What this skill does
# 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. ```bash npx ai-agent-skills validate ``` This checks: required fields, folder consistency, frontmatter validity, collection integrity, and generated doc sync. 2. Run doctor to check installed skills health. ```bash npx ai-agent-skills doctor --format json ``` 3. Check for skills that may need updates. ```bash npx ai-agent-skills check --format json ``` 4. Verify generated docs are in sync. ```bash npx ai-agent-skills build-docs --dry-run --format json ``` If `currentlyInSync` is false, regenerate: ```bash npx ai-agent-skills build-docs ``` 5. Review the curation queue for skills needing attention. ```bash 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.
Related in workflow
absolute-work
IncludedEnd-to-end, phase-gated software development lifecycle for AI agents. Turns a ticket, task, plan, or migration into a validated design, a dependency-graphed task board, and verified code. Triggers on "build this end-to-end", "plan and build", "break this into tasks", "pick up this ticket", "grill me on this", "run this migration", "absolute-work this", or any multi-step development task. Relentlessly interviews to a shared design, writes a reviewed spec, decomposes into atomic tasks on a persistent markdown board, then peels tasks one safe wave at a time with test-first verification. Handles features, bugs, refactors, greenfield projects, planning breakdowns, and migrations.
absolute-simplify
IncludedAutonomously simplifies code in your working changes or targeted files. Detects staged or unstaged git changes, analyzes for simplification opportunities following clean code and clean architecture principles, applies improvements directly, runs tests to verify nothing broke, and shows a structured summary with reasoning. Triggers on "simplify this", "refactor this", "clean up my changes", "absolute-simplify", "simplify my code", "make this cleaner", "tidy this up", "reduce complexity", "flatten this", "remove dead code", or when code needs clarity improvements, nesting reduction, or redundancy removal. Language-agnostic at base with deep opinions for JS/TS/React, Python, and Go.
sentry-sdk-upgrade
IncludedUpgrade the Sentry JavaScript SDK across major versions. Use when asked to upgrade Sentry, migrate to a newer version, fix deprecated Sentry APIs, or resolve breaking changes after a Sentry version bump.
when-using-advanced-swarm-use-swarm-advanced
IncludedAdvanced swarm patterns with dynamic topology switching and self-organizing behaviors for complex multi-agent coordination
development-workflow
IncludedDetailed development workflow with modular patterns for git, review, testing, and deployment.
project-execution
IncludedExecutes implementation plans with progress tracking, checkpoint validation, and quality gates. Use after planning is complete and tasks are ready to implement.