ai-gleanings

Generate a tailored `docs-optimizer` skill plus a drift-check harness for a target repo, calibrated to its conventions, validation infrastructure, and actual drift patterns. Use when setting up docs governance for a repo that doesn't have it, or when asked to "set up drift detection", "scaffold docs governance", or "create a docs-optimizer for this repo".

Audit, consolidate, and clean up instruction docs (`README.md`, `AGENTS.md`, `CLAUDE.md`, contributor guides, `docs/` trees) — finds drift, conflicts, redundancy, and broken references across files, then optionally applies fixes. Use when cleaning up docs, after a refactor has left docs behind, when consolidating overlapping files, or when asked to audit, review, clean up, consolidate, optimize, or fix documentation.

Audit agent skills using marketplace-quality heuristics. Performs automated structure analysis, token optimization, routing integrity checks, and content quality assessment. Generates detailed reports with severity-categorized findings and concrete fixes. Use when preparing skills for publication, conducting quality reviews, or when asked to "audit this skill", "review skill quality", "check skill structure", or "validate skill for release".