skill-auditor_skill

Overview

This skill audits an existing skill ecosystem and delivers actionable recommendations to improve agent-friendliness, consistency, and maintainability. It inventories global and project-level skills, evaluates individual skill quality, and produces a prioritized report with remediation steps. Use it to get a clear health score and concrete fixes for immediate wins.

How this skill works

The auditor scans skill directories to build an inventory, extracts metadata and size metrics, and detects supporting files like references, scripts, and assets. It runs per-skill checks on metadata quality, content length, progressive disclosure, actionability, and output contracts. Finally, it analyzes the collection for coverage gaps, overlaps, naming consistency, and organizational issues, and generates a prioritized report with grades and remediation steps.

When to use it

• After adding several new skills to check for overlap and consistency
• Quarterly or before major releases to maintain ecosystem health
• When skills feel ineffective or produce inconsistent outputs
• Before sharing or publishing a skill collection to external users
• When you need a prioritized list of concrete improvements

Best practices

• Keep skill descriptions concise and include clear "use when" triggers
• Split long content into reference files and keep manifests short
• Define explicit output contracts so related skills interoperate
• Use consistent naming and trigger patterns across similar skills
• Script repeatable operations to reduce manual steps and drift

Example use cases

• Audit a mixed set of global and project-scoped skills to find duplication
• Generate a health report with grades and a prioritized remediation plan
• Identify skills that are too long and recommend moving details to references
• Standardize trigger phrases and output formats across a domain
• Detect missing automation and recommend scripts for common tasks