auditing-skills

Audit Skill.md files for YAML compliance and XML structure quality.

1|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/outcomeengineering/spx-claude --skill auditing-skills-outcomeengineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auditing-skills
Source: https://github.com/outcomeengineering/spx-claude/tree/main/plugins/claude/skills/auditing-skills
Command: npx skills add https://github.com/outcomeengineering/spx-claude --skill auditing-skills-outcomeengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that other Skills adhere to best practices for structure, clarity, and operational effectiveness, improving their reliability and usability.

Core Features & Use Cases

  • Comprehensive Auditing: Evaluates Skills based on YAML compliance, XML structure, content quality, and operational effectiveness.
  • Actionable Feedback: Provides detailed findings categorized by severity (Critical, Recommendations, Quick Fixes) with specific locations and suggested remediations.
  • Use Case: When you've developed a new Skill or want to improve an existing one, use this auditing Skill to get a thorough review against established standards, ensuring it's robust and maintainable.

Quick Start

Use the auditing-skills skill to audit the 'create-skill' skill.

Frequently Asked Questions about auditing-skills

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

FAQPage Schema
How do I audit a Skill.md file against best practices for XML structure and YAML compliance?

To audit a Skill.md file, evaluate its YAML compliance, pure XML structure, and progressive disclosure. This process checks required XML tags, constraint strength, and procedural balance to provide actionable findings with contextual judgment rather than arbitrary scores.

What does a skill audit check for in operational effectiveness and content quality?

A skill audit checks operational effectiveness by reviewing error handling coverage, example quality, and conciseness. It assesses procedural and operational balance, ensuring the skill provides robust, maintainable, and clearly structured operational guidance.

How do I review a custom skill to ensure it follows progressive disclosure and conciseness?

Reviewing a custom skill involves evaluating its progressive disclosure and conciseness by examining the XML structure quality and constraint strength. The audit provides categorized findings like Critical or Quick Fixes with specific locations and suggested remediations.

Can I use an automated skill audit to find missing required XML tags in my Skill.md?

Yes, an automated skill audit identifies missing required XML tags in your Skill.md. It evaluates the file against established standards for pure XML structure and YAML compliance, delivering detailed remediations to improve reliability.

What is the best way to get actionable feedback on skill development and code review standards?

The best way to get actionable feedback on skill development is to run a comprehensive audit focusing on content quality and XML structure. This yields categorized severity findings with specific locations, ensuring your skill meets code review best practices.

Are there limitations to skill auditing when checking conditional XML tags and error handling coverage?

Skill auditing limitations involve relying on contextual judgment rather than arbitrary scores when checking conditional XML tags and error handling coverage. It provides actionable findings, but complex procedural logic may require manual review beyond automated structural checks.