skills-audit

Audit .agents/skills SKILL.md files for duplicates, overlaps, and inconsistencies.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/alceupassos/hub --skill skills-audit-alceupassos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skills-audit
Source: https://github.com/alceupassos/hub/tree/main/.agents/skills/skills-audit
Command: npx skills add https://github.com/alceupassos/hub --skill skills-audit-alceupassos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures your AI skills are up-to-date, consistent, and efficient by performing automated audits on .agents/skills SKILL.md files.

Core Features & Use Cases

  • Duplicate and Redundancy Check: Identifies duplicate, overlapping, stale, inconsistent, or broken skills and suggests merge/delete candidates.
  • Inventory and Reporting: Generates a detailed report of all SKILL.md files, grouped by domain, to identify new arrivals or changes.
  • Description Format Consistency: Applies standard templates to descriptions to ensure clarity and maintainability.
  • Stale-skill Check: Flags skills that may be outdated or no longer necessary based on changes to their underlying codebases.
  • Cross-reference Integrity: Checks for broken references to other skills and suggests fixes.

Quick Start

Run the 'skills-audit' command to start the audit process.

Frequently Asked Questions about skills-audit

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

FAQPage Schema
How do I audit AI skills for duplicates and inconsistencies in SKILL.md files?

You audit AI skills by running automated checks on .agents/skills SKILL.md files. This process identifies duplicate, overlapping, and inconsistent skills, suggesting merge or delete candidates to maintain a clean skill set.

What is the best way to maintain consistency across AI skill descriptions?

The best way to maintain consistency is applying standard templates to SKILL.md files. This ensures clarity and maintainability across your inventory by formatting descriptions uniformly during the audit.

How do I identify outdated or stale skills in my codebase?

You identify outdated or stale skills by checking SKILL.md files against their underlying codebases. The audit flags skills that are outdated or no longer necessary based on recent codebase changes.

Can I check for broken references between different AI skills?

Yes, you can check for broken references between AI skills. The audit verifies cross-reference integrity within SKILL.md files, identifies broken links to other skills, and suggests appropriate fixes.

How do I generate an inventory report of all my AI skills grouped by domain?

You generate an inventory report by running an audit on your .agents/skills directory. It creates a detailed report of all SKILL.md files grouped by domain to track new arrivals or changes.