What happens if a skill fails validation?

The validator will provide an 'ERROR' status with a specific list of issues that need to be resolved before the skill is considered production-ready.

Can it fix validation errors automatically?

Yes, for common issues such as missing frontmatter flags or incorrect formatting, the skill can offer and apply automatic fixes to the SKILL.md file.

What does the Skill Structure Validator check for?

It validates the folder structure, YAML frontmatter fields (like name and description), naming conventions, and the presence of essential documentation sections like 'When to Use'.

Why is the user-invocable flag important?

This flag determines whether a skill is manually triggerable by a user or if it should only be activated autonomously by the AI agent during a workflow.

Does it enforce specific naming conventions?

Yes, it ensures that folder names match skill names and use kebab-case without special characters for maximum compatibility.

Skill Structure Validator

Name: Skill Structure Validator
Author: TomazWang

byTomazWang

0•

開発者ツール

Validates Claude Code skills for architectural integrity, frontmatter compliance, and development best practices.

The Skill Structure Validator is a specialized utility designed to ensure that custom Claude Code skills adhere to standard architectural patterns and metadata requirements. It automatically audits folder structures, YAML frontmatter syntax, and mandatory content sections like 'When to Use' and usage examples, providing actionable feedback and automated fixes to streamline the skill creation process and ensure consistent agent behavior.

主な機能

010 GitHub stars

02Content audits for triggers and usage examples

03Naming convention enforcement using kebab-case

04Automated folder and file structure integrity checks

05YAML frontmatter syntax and field validation

06Actionable reporting with Pass/Warning/Error statuses

ユースケース

01Auditing existing skill libraries for documentation and metadata consistency

02Verifying a new skill's configuration before committing to a repository

03Automating the quality assurance process for custom Claude Code plugins

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill