Skill Audit for YAML/XML Compliance

VerifiedSafe

Audits skills for YAML compliance, pure XML structure, progressive disclosure, and best practices.

Sby Skills Guide Bot
DevelopmentIntermediate
107/25/2026
Claude Code
#skill-audit#compliance#best-practices#xml-structure#quality

Recommended for

Our review

Audits an Agent Skills file for compliance with best practices, including pure XML structure and progressive disclosure.

Strengths

  • Ensures skills follow required structure, tags, and formatting standards.
  • Provides detailed findings with file:line locations and actionable recommendations.
  • Automates quality review, reducing manual oversight.

Limitations

  • Relies on up-to-date best practices documentation being correct and accessible.
  • May produce false positives if rules misapply to edge cases.
  • Requires correct subagent invocation and proper argument passing.
When to use it

When creating or editing a skill and you need to validate its structure and compliance before usage or sharing.

When not to use it

If you are not working on Agent Skills files or need a general-purpose code linter for other languages.

Security analysis

Safe
Quality score80/100

The skill solely invokes a subagent for auditing, with no execution of system commands, network calls, or dangerous operations. No tools are declared, and it does not handle sensitive data.

No concerns found

Examples

Basic skill audit
Audit the skill at ./skills/deploy.md
Audit with full path
Run skill auditor on /home/user/project/skills/my-skill.md

description: Audit skill for YAML compliance, pure XML structure, progressive disclosure, and best practices argument-hint: <skill-path>

<objective> Invoke the skill-auditor subagent to audit the skill at $ARGUMENTS for compliance with Agent Skills best practices.

This ensures skills follow proper structure (pure XML, required tags, progressive disclosure) and effectiveness patterns. </objective>

<process> 1. Invoke skill-auditor subagent 2. Pass skill path: $ARGUMENTS 3. Subagent will read updated best practices (including pure XML structure requirements) 4. Subagent evaluates XML structure quality, required/conditional tags, anti-patterns 5. Review detailed findings with file:line locations, compliance scores, and recommendations </process>

<success_criteria>

  • Subagent invoked successfully
  • Arguments passed correctly to subagent
  • Audit includes XML structure evaluation </success_criteria>
Related skills