skills.rest
alongor666
alongor666COMMUNITY
Explore all skills by this author →
GitHub

skill-quality-validator

Validate Claude skills against official quality standards and generate scored reports.

2|Updated Nov 2, 2025
Search Tags:#code quality#skill development#best practices#validation#AI skill#documentation quality#Claude skill#skill quality
One-click install
npx skills add https://github.com/alongor666/chexianduoweifenxi --skill skill-quality-validator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-quality-validator
Source: https://github.com/alongor666/chexianduoweifenxi/tree/main/.claude/skills/skill-quality-validator
Command: npx skills add https://github.com/alongor666/chexianduoweifenxi --skill skill-quality-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

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

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.

Frequently Asked Questions about skill-quality-validator

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

FAQPage Schema
How do I validate a Claude Skill against official quality standards?▼

Validating a Claude Skill involves running an automated check against official quality standards across 7 dimensions: structural integrity, YAML frontmatter, description quality, content structure, file references, script quality, and documentation. The validator analyzes your skill directory or .skill package and outputs a detailed report with a 0-100 score and A-F grade.

What does the validator check in a skill's SKILL.md and YAML frontmatter?▼

The validator enforces essential requirements including SKILL.md presence, proper YAML frontmatter structure, description length and clarity, and complete documentation of all scripts. It identifies missing or malformed fields and flags them as critical issues that must be resolved before publication.

Can I validate multiple skills at once or only individual skill directories?▼

The validator supports both single skill directories and batch audits of multiple .skill packages. You can check individual skills one at a time or process multiple packaged skills in a single operation, making it efficient for managing large skill portfolios.

What types of issues does the quality report include and how are they categorized?▼

The detailed report categorizes issues as Critical, Warning, or Suggestion, each with specific improvement recommendations. Critical issues block compliance, warnings indicate best-practice violations, and suggestions offer enhancement opportunities to improve overall skill quality.

Do I need to publish my skill before running the quality validator?▼

No. Run the validator before publishing to catch compliance issues early. It works on local skill directories during development, allowing you to fix problems like missing SKILL.md files or underdocumented scripts before your skill goes live.

What happens if my skill fails the quality check—can I still publish it?▼

Critical issues must be resolved to meet official standards; the validator enforces essential requirements like SKILL.md presence and YAML frontmatter. Addressing critical issues ensures your skill complies with guidelines, while warnings and suggestions improve quality but may not block publication.

Related Skills

Explore More Software Engineering Skills→
jacexhjacexh

skill-creator

Generate SKILL.md templates, validate frontmatter, and package skills into .skill files.

Community
Intermediate
pradyumnasagarpradyumnasagar
6

roadmap-author

Guide authors through creating and validating ORS SKILL.md files.

Community
Intermediate
wutongshenqiuwutongshenqiu

lint

Run linter checks and apply automatic fixes to codebases.

Community
Intermediate
paultyngpaultyng
9

create-pr

Create standardized GitHub pull requests with Conventional Commit titles and templates.

Community
Intermediate