audit-overlays

You can audit overlays and family customizations by manually invoking the audit command, which validates overlay targets against shipped skills, applies migrations for renamed skills, and surfaces orphans requiring user attention.

Stale rules in family customizations arise when outdated configurations no longer match current skills. Running a customization audit scans family-customizations.md to flag these stale rules and identify potential hygiene issues.

A customization audit is needed during routine governance checks or immediately after a plugin update. This manual, user-initiated audit ensures per-skill overlays target valid skill-ids and maintains overall customization integrity.

The audit applies migrations from the plugin's migrations.md to handle renamed skills. It then surfaces orphan overlays that no longer target a valid skill-id, logging changes and requiring explicit user confirmation before taking destructive actions.

The audit requires explicit user confirmation for destructive actions rather than automatically fixing outdated customizations. It logs detected changes, validates frontmatter integrity, and surfaces issues for manual review before proceeding.

During an overlay integrity validation, the audit checks frontmatter integrity, resolves file targets against current shipped skills, and scans for renamed overlays or stale rules across all family folders.