What specifically does the Skill Quality Checker validate?

It validates YAML frontmatter syntax, required fields (name, description), naming conventions, description voice and length, file structure, and adherence to the Agent Skills specification.

Can this skill automatically fix errors in my SKILL.md?

Yes, after providing a report, the skill can optionally apply suggested fixes to your SKILL.md file and related structure if you approve the changes.

Why does it check for third-person voice in descriptions?

Claude Code skills inject descriptions into the system prompt. Using third-person avoids persona confusion and ensures Claude understands the skill as a capability rather than a change to its identity.

How do I trigger a check on a specific skill?

You can trigger a review by mentioning keywords like --check-skill, --validate-skill, or --review-skill followed by the name of the skill you want to audit.

Skill Quality Checker

Name: Skill Quality Checker
Author: galligan

bygalligan

•

Developer Tools

Validates and reviews Claude Code skills against official specifications to ensure high quality, proper syntax, and discoverability.

About

The Skill Quality Checker is a specialized diagnostic tool designed to help developers build superior Claude Code skills by enforcing the Agent Skills specification. It automates the tedious process of checking YAML frontmatter syntax, naming conventions, and file structures while providing a qualitative layer of review for descriptions and trigger keywords. By analyzing skill files against industry best practices, it generates detailed reports with actionable before-and-after examples, helping you optimize your skills for better performance and easier maintenance.

Key Features

Comprehensive YAML frontmatter and syntax validation
2 GitHub stars
Naming convention enforcement for files and directories
Description quality review for voice, length, and discoverability
Automated discovery of broken file references and structural issues
Actionable improvement suggestions with optional automated fixes

Use Cases

Auditing legacy skill libraries for consistency and specification compliance
Pre-commit validation to ensure new skills are production-ready
Optimizing skill descriptions to improve Claude's activation accuracy

About

Key Features

Comprehensive YAML frontmatter and syntax validation
2 GitHub stars
Naming convention enforcement for files and directories
Description quality review for voice, length, and discoverability
Automated discovery of broken file references and structural issues
Actionable improvement suggestions with optional automated fixes

Use Cases

Auditing legacy skill libraries for consistency and specification compliance
Pre-commit validation to ensure new skills are production-ready
Optimizing skill descriptions to improve Claude's activation accuracy