skill-audit

Audit .claude/skills directories for structural compliance and functional gaps.

Updated May 7, 2026
One-click install
npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill skill-audit-tmalcolm-0607
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-audit
Source: https://github.com/tmalcolm-0607/mad-council-claw/tree/main/.claude/skills/skill-audit
Command: npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill skill-audit-tmalcolm-0607

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about skill-audit

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

FAQPage Schema
How do I audit custom AI skills for structural compliance and broken references?

You can audit custom AI skills by running an automated structural compliance check across your skill ecosystem to detect dead cross-references, missing frontmatter fields, and tool permission mismatches that degrade agent workflow reliability.

What are functional gaps in AI agent skills and how do I detect them?

Functional gaps in AI agent skills are unenforced promises, silent failure risks, and context leaks not caught by structural checks. You detect them by running deep functional gap analysis with advanced checks across your skill batches.

Can I run a compliance check on a specific batch of skills rather than all of them?

Yes, you can limit audits to specific skill groups such as MAD Core or Review/Lint. Batch auditing allows you to target configurable skill groups for focused structural checks and functional analysis.

Does skill audit work with Claude Code frameworks and custom skills in .claude/skills?

Yes, skill audit supports projects using Claude Code or similar agent frameworks with custom skills stored in .claude/skills, applying both quick structural checks and deep functional analysis to maintain workflow reliability.

How do I automatically fix missing frontmatter and version bumps in my AI skills?

You can automatically apply fixes for common structural issues like missing documentation sections and version bumps by enabling the optional automated remediation feature during your skill ecosystem audit.

When should I run a skill ecosystem compliance check to prevent agent failures?

You should run a skill ecosystem compliance check before a release or major workflow update to catch broken references, stale versions, and missing documentation that would otherwise cause agent failures in production.