What exactly does the Skill Quality Validator check?

It validates four key areas: the folder/file structure, the SKILL.md frontmatter syntax, the clarity of the 'When to Use' trigger section, and the overall quality of the instructions.

Does this help with skill auto-activation?

Absolutely. It specifically checks that your trigger keywords and 'When to Use' formatting align with what Claude needs to recognize and activate the skill automatically.

Can I run this validation manually?

Yes, you can invoke it manually using the /skill-creator:validate-skill-structure command followed by the path to your skill directory.

What are the different validation levels?

The tool provides three levels: PASS (ready to use), WARNING (functional but needs improvement), and ERROR (critical issues that must be fixed).

Skill Quality Validator

Name: Skill Quality Validator
Author: TomazWang

byTomazWang

0•

開発者ツール

Validates Claude Code skill structures and documentation against standardized schemas to ensure reliability and seamless auto-activation.

The Skill Quality Validator is a specialized utility designed to maintain high standards for Claude Code skills. It performs comprehensive automated checks on folder hierarchies, SKILL.md frontmatter, and 'When to Use' sections to ensure every skill is properly formatted and easily discoverable by the AI. By verifying content against predefined schemas for quality and completeness, it helps developers identify structural errors, missing triggers, or unclear documentation before deployment, leading to more robust and predictable agentic workflows.

主な機能

01SKILL.md frontmatter schema validation for kebab-case naming

02Content quality assessment for clarity and completeness

03Trigger condition analysis for improved auto-activation

04Detailed validation reporting with pass, warning, and error states

050 GitHub stars

06Automated folder and file structure verification

ユースケース

01Troubleshooting why a custom skill is not triggering or functioning as expected

02Verifying a newly created skill before distribution to a repository

03Enforcing consistent documentation standards across large skill collections

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomazwang/agent-toolkit validate-skill-quality

For use in Claude.ai and ChatGPT

Download Skill