skills-audit

Audit SKILL.md files under .agents/skills and generate a findings report.

1|Updated May 20, 2026
One-click install
npx skills add https://github.com/mDevsLabs/mAI --skill skills-audit-mdevslabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skills-audit
Source: https://github.com/mDevsLabs/mAI/tree/main/.agents/skills/skills-audit
Command: npx skills add https://github.com/mDevsLabs/mAI --skill skills-audit-mdevslabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a disciplined approach to auditing and maintaining the accuracy, consistency, and relevance of local skill definitions stored under .agents/skills. It helps prevent drift, duplicates, and stale entries that degrade the reliability of the skills catalog.

Core Features & Use Cases

  • Inventory all SKILL.md files across the skills catalog to establish a fresh census.
  • Pull and compare frontmatter across skills to surface duplicates, renamed or deleted references, and malformed entries.
  • Detect overlap, drift, or broken references and guide consolidation or archival decisions.
  • Enforce a consistent description format and cross-skill references to keep the catalog navigable and maintainable.
  • Use Case: Run a weekly audit to keep the skill catalog clean and aligned with the project’s evolving workflow.

Quick Start

Run the audit to enumerate all .agents/skills/*/SKILL.md files and generate a findings report.

Frequently Asked Questions about skills-audit

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

FAQPage Schema
How do I audit my local skills catalog for drift and broken references?

To audit your skills catalog, run a static analysis on all SKILL.md files under .agents/skills to compare frontmatter, detect duplicates, and surface broken cross-skill references. This generates a findings report for consolidation or archival decisions.

What is the best way to maintain consistency across multiple SKILL.md files?

The best way to maintain consistency across SKILL.md files is to inventory the .agents/skills directory and enforce a uniform description format. Comparing frontmatter helps identify renamed entries and malformed metadata that degrade catalog navigability.

Do I need external dependencies to check my repository's skills catalog?

No dependencies are required to check your repository's skills catalog. The audit relies entirely on standard tooling and static analysis of the SKILL.md frontmatter, body, and directory structure, requiring no external installations or components.

Why should I run a consistency check on my .agents/skills directory?

You should run a consistency check on your .agents/skills directory to prevent drift, duplicates, and stale entries. Regular audits keep the local skill definitions accurate and aligned with the project's evolving software development workflows.

Can this audit detect overlapping or duplicate skill definitions automatically?

Yes, the audit can detect overlapping or duplicate skill definitions automatically. By pulling and comparing frontmatter across all SKILL.md files, it guides consolidation decisions and flags redundant or stale entries in the catalog.

When should I archive local skills during repository maintenance?

You should archive local skills during repository maintenance when the audit reveals broken references, stale entries, or significant drift. The findings report from the static analysis guides your archival decisions to keep the catalog clean.