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.

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

01Comprehensive YAML frontmatter and syntax validation

022 GitHub stars

03Naming convention enforcement for files and directories

04Description quality review for voice, length, and discoverability

05Automated discovery of broken file references and structural issues

06Actionable improvement suggestions with optional automated fixes

Use Cases

01Auditing legacy skill libraries for consistency and specification compliance

02Pre-commit validation to ensure new skills are production-ready

03Optimizing skill descriptions to improve Claude's activation accuracy

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add galligan/my-skillstash skills-check

For use in Claude.ai and ChatGPT

Download Skill