audit-overlays

Audit overlays and family customizations for integrity after plugin updates.

Updated Apr 24, 2026

Search Tags:#migrations #audit #plugin #governance #overlays #customizations

Ready to run

npx skills add https://github.com/intelligent-alpha/plugins --skill audit-overlays

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: audit-overlays
Source: https://github.com/intelligent-alpha/plugins/tree/main/intelligent-alpha/skills/audit-overlays
Command: npx skills add https://github.com/intelligent-alpha/plugins --skill audit-overlays

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates that every per-skill overlay still targets a valid skill-id, applies migrations from the plugin's migrations.md when skills have been renamed, and surfaces orphans that need user attention. Also scans family-customizations.md for stale rules. Manual invocation only — runs when the user explicitly asks for a customization audit, typically after a plugin update.

Core Features & Use Cases

Validates overlay targets against current shipped skills.
Applies migrations for renamed skills and surfaces orphan overlays for review.
Scans family-customizations.md for stale rules and flags potential hygiene issues.
Manual, user-initiated audit invoked after plugin updates or at routine governance checks.

Quick Start

Run the audit by invoking /intelligent-alpha:audit-overlays to validate all overlays and family customizations.

Frequently Asked Questions about audit-overlays

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I audit family customizations and overlays after a plugin update?▼

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.

What causes stale rules in family customizations and how do I scan for them?▼

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.

When do I need to run a customization audit for governance checks?▼

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.

How does the audit handle renamed skills and orphan overlays?▼

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.

Does the audit automatically fix outdated customizations or require manual confirmation?▼

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.

What is checked during an overlay integrity validation?▼

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.