skill-auditor

Audit skill definitions for required fields, sections, and placeholder avoidance.

1|Updated Jan 4, 2026

Search Tags:#documentation #validation #audit #skills #quality #frontmatter

Ready to run

npx skills add https://github.com/BarisSozen/claude --skill skill-auditor

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-auditor
Source: https://github.com/BarisSozen/claude/tree/main/.claude/skills/skill-auditor
Command: npx skills add https://github.com/BarisSozen/claude --skill skill-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill helps teams ensure that skill definitions are complete, consistent, and in line with project conventions by performing automated validation and quality checks.

Core Features & Use Cases

Frontmatter validation: checks required fields (name, description) and ensures they are well-formed.
Structural checks: verifies presence of key sections like When to Use and Workflow and flags gaps.
Quality guidance: produces structured audit reports with recommendations and potential decomposition into sub-skills.

Quick Start

Run the audit against your skills directory:

python .claude/skills/skill-auditor/scripts/audit_skills.py .claude/skills/
python ... --json to generate machine-readable results
Review the report and apply fixes to SKILL.md or directory structure

Frequently Asked Questions about skill-auditor

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

FAQPage Schema

How do I validate skill definitions for quality and completeness?▼

To validate skill definitions for quality, run an audit script against your skills directory to check frontmatter fields, section presence, and placeholder avoidance. This generates a structured report with actionable recommendations and decomposition guidance.

What does a skill definition audit check for in a repository?▼

A skill definition audit checks for required frontmatter fields like name and description, verifies key sections such as When to Use and Workflow are present, and flags gaps or placeholders to ensure adherence to project conventions.

How do I generate machine-readable audit reports for skill validation?▼

To generate machine-readable audit reports for skill validation, run the audit script with the JSON flag against your skills directory. This outputs structured validation results capturing frontmatter errors and structural gaps for automated processing.

Can I audit skill frontmatter and structure across a full repository?▼

Yes, you can audit skill frontmatter and structure across a full repository by pointing the audit script to your skills directory. It evaluates all skill definitions, enforcing required fields and section presence while offering decomposition recommendations.

When do I need to audit skill definitions for convention adherence?▼

You need to audit skill definitions for convention adherence when managing a repository of skills to ensure consistent frontmatter, complete structural sections, and proper quality standards before deployment or team collaboration.

What are the limitations of automated skill definition validation?▼

Automated skill definition validation is limited to structural and frontmatter checks, enforcing required fields and section presence, but cannot assess semantic quality or contextual appropriateness of the skill content itself.