What problem does it solve?
This Skill eliminates the risk of broken, non-compliant skill ecosystems that cause agent workflow failures, wasted maintenance effort, and inconsistent behavior across AI-powered development tools.
Core Features & Use Cases
- Structural Compliance Checks: Automatically detect stale versions, dead cross-references, missing required documentation sections, tool permission mismatches, and missing frontmatter fields across all skills.
- Deep Functional Gap Analysis: Optionally run 8 advanced checks to identify unenforced promises, silent failure risks, orphaned task risks, and context leaks that aren't caught by structural checks.
- Batch Auditing & Auto-Fix: Limit audits to specific skill groups (MAD Core, Review/Lint, etc.) and automatically apply fixes for common structural issues like version bumps and missing sections.
- Use Case: A team maintaining 30+ custom AI skills can run this audit before a release to catch broken references and missing documentation that would otherwise cause agent failures in production.
Quick Start
Use the skill-audit skill to run a full compliance and gap audit of all skills in your .claude/skills directory and generate a detailed findings report.