skill-validator

Validate Claude Code components against specifications before committing or distributing.

2|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/jbabin91/super-claude --skill skill-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-validator
Source: https://github.com/jbabin91/super-claude/tree/main/plugins/claude-tools/skills/skill-validator
Command: npx skills add https://github.com/jbabin91/super-claude --skill skill-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often struggle to ensure their Claude Code skills, commands, agents, hooks, and plugins adhere to specifications and best practices. This leads to errors, inconsistent behavior, and difficulties in sharing or distributing components. This Skill automates the rigorous validation process, ensuring your creations are robust and reliable.

Core Features & Use Cases

  • Comprehensive Validation: Checks structure, format, best practices, and common issues for all Claude Code component types (skills, commands, agents, hooks, plugins).
  • Early Issue Detection: Catches problems during development, before committing or distributing, saving time and effort in the long run.
  • Use Case: Before publishing a new plugin to the marketplace, use this Skill to automatically verify that all its skills, commands, and agents meet Anthropic's specifications and community best practices, ensuring a smooth user experience for anyone who installs it.

Quick Start

Example: Validate a specific skill

First, ensure the 'skill-tools' plugin is installed:

/plugin install skill-tools

Then, in Claude Code, simply ask:

"Validate the skill in my current directory."

Or, to validate an entire plugin:

"Check the quality of my 'my-plugin' plugin."

Frequently Asked Questions about skill-validator

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

FAQPage Schema
How do I validate Claude Code skills and plugins before publishing?

Validation checks your skills, commands, agents, hooks, and plugins against specifications for structure, naming conventions, required fields, and best practices. Run the validator in your project directory to catch issues before committing or distributing, ensuring components meet quality standards and marketplace requirements.

What does quality validation check in Claude Code components?

Quality validation enforces YAML/JSON frontmatter correctness, required fields presence, kebab-case naming, semantic versioning, trigger definitions, absence of TODOs, defined workflows, usage instructions, and safety requirements. It provides actionable remediation guidance for each issue found.

Can I validate an entire plugin or just individual skills?

You can validate individual skills in your current directory or check an entire plugin at once. The validator applies comprehensive checks across all component types within a plugin, making it ideal for pre-release validation and marketplace deployment workflows.

When should I run component validation in my development workflow?

Run validation during development to catch structural and best-practice issues early, before peer review or committing changes. Use it again before publishing to the marketplace to verify all skills, commands, and agents meet Anthropic specifications and community standards.

What happens if validation finds issues in my components?

Validation identifies problems in structure, format, naming, versioning, triggers, documentation, and safety checks, then provides specific remediation guidance for each issue. You can fix problems iteratively and re-run validation to confirm compliance before distribution.

Do I need to install anything before using the validator?

Yes, install the skill-tools plugin first using `/plugin install skill-tools`. This provides the validation functionality needed to check your Claude Code components against specifications and best practices.