skill-quality-validator

What problem does it solve?

This Skill automates the rigorous quality assurance process for Claude Skills, ensuring they adhere to official best practices and standards. It eliminates manual review, reduces errors, and guarantees high-quality, compliant skills, saving developers and product managers significant time and effort.

Core Features & Use Cases

• Comprehensive Quality Checks: Validates skills across 7 dimensions: structural integrity, YAML frontmatter, description quality, content structure, file references, script quality, and documentation.
• Automated Scoring & Grading: Assigns a score (0-100) and a grade (A-F), with clear pass/fail criteria, based on a predefined checklist.
• Detailed Issue Reporting: Provides a structured report categorizing issues as Critical, Warning, or Suggestion, each with specific improvement recommendations.
• Flexible Input: Supports checking both skill directories and packaged .skill files.
• Use Case: A developer has just finished creating a new Claude Skill. Before publishing, they use this validator to automatically check if it meets all official guidelines. The report highlights a missing SKILL.md field and an overly long description, allowing for quick, targeted fixes to ensure compliance.

Quick Start

Check the quality of the skill located at './my-new-skill' and generate a detailed report.