claude:validate-skills

Validate Claude Code skill files for YAML frontmatter and schema compliance.

2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/amdmax/claude_marketplace --skill claude-validate-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude:validate-skills
Source: https://github.com/amdmax/claude_marketplace/tree/main/.claude/skills/claude%3Avalidate-skills
Command: npx skills add https://github.com/amdmax/claude_marketplace --skill claude-validate-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the validation of Claude Code skill files, ensuring they adhere to proper formatting, syntax, and configuration standards, preventing errors and improving reliability.

Core Features & Use Cases

  • YAML Frontmatter Validation: Checks for correct delimiters, syntax, and required fields (name, description).
  • Schema Compliance: Validates against official Claude Code skill options and hook configurations.
  • Use Case: Before committing new skills or stopping a session, run this validator to catch common mistakes like missing descriptions or invalid hook events, ensuring your skills are robust.

Quick Start

Run the validation script directly from your terminal using bash .claude/skills/claude:validate-skills/scripts/validate-all-skills.sh.

Frequently Asked Questions about claude:validate-skills

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

FAQPage Schema
How do I validate YAML frontmatter in Claude Code skill files?

You can validate YAML frontmatter in Claude Code skill files by running the validation script directly from your terminal, which checks for correct delimiters, syntax, and required fields like name and description.

What are the required fields for Claude Code skill configurations?

The required fields for Claude Code skill configurations are name and description. The validation process checks your YAML frontmatter for these mandatory fields and ensures adherence to official schema definitions and hook configurations.

Can I automate skill validation checks using hooks?

Yes, you can automate skill validation checks using hooks. The validator supports automated checks to catch common mistakes like missing descriptions or invalid hook events before committing new skills or stopping a session.

Do I need yq installed to check Claude Code skills against schema definitions?

Yes, you need yq installed to check Claude Code skills against schema definitions. The validation script depends on yq to parse YAML frontmatter and verify compliance with official Claude Code skill options and hook configurations.

Why does my Claude Code skill fail validation due to invalid hook events?

Your Claude Code skill fails validation due to invalid hook events when the YAML frontmatter does not adhere to the official hook configuration schema. The validator checks schema compliance to prevent these common formatting and configuration errors.