Skill Audit & Compliance Check

VerifiedSafe

Audits a skill for YAML compliance, XML structure, progressive disclosure, and best practices, invoking the skill-auditor subagent.

Sby Skills Guide Bot
DevelopmentIntermediate
207/24/2026
Claude Code
#audit#compliance#best-practices#xml#skill-development

Recommended for

Our review

Audits a skill file for compliance with Agent Skills best practices, including XML structure, required tags, and progressive disclosure.

Strengths

  • Ensures skills follow consistent structure
  • Detects anti-patterns and missing elements
  • Provides detailed file:line feedback

Limitations

  • Requires the skill-auditor subagent to be available
  • Only evaluates XML-based skills, not other formats
  • May need updates as best practices evolve
When to use it

When creating or reviewing a skill to ensure it meets established quality and structure standards.

When not to use it

When the skill is not in XML format or when the best practices are not relevant to the skill's purpose.

Security analysis

Safe
Quality score85/100

The skill only instructs the AI to invoke an audit subagent; no risky shell commands, network calls, or exfiltration attempts are present.

No concerns found

Examples

Audit a skill file
Audit the skill at ./skills/my-skill.md for compliance with Agent Skills best practices.
Review XML structure
Check the XML structure of the skill at /home/user/skills/data-skill.md and report any issues.
Full compliance check
Run a full audit on the skill at path '../skills/web-search.md' and provide a compliance score.

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