skills.rest
firstsun-dev
firstsun-devOFFICIAL
Explore all skills by this author →
WebsiteGitHub

validate-skills

Validate skill directories against the agentskills.io specification and Claude Code best practices.

1|Updated Apr 29, 2026
Search Tags:#linting#skills#spec#claude-code#validate#agentskills
One-click install
npx skills add https://github.com/firstsun-dev/yao-agent-skills --skill validate-skills-firstsun-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: validate-skills
Source: https://github.com/firstsun-dev/yao-agent-skills/tree/main/external/basic/validate-skills
Command: npx skills add https://github.com/firstsun-dev/yao-agent-skills --skill validate-skills-firstsun-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates skills in this repository against the agentskills.io spec and Claude Code best practices, ensuring consistency and compliance across all skill units.

Core Features & Use Cases

  • Verifies skill metadata (name, description, license, metadata) for each skill directory.
  • Checks naming conventions, description length, and optional fields alignment against spec.
  • Provides guidance for remediation and auditing of skill quality.

Quick Start

Run the validator to scan all skill directories and report non-conformant SKILL.md files.

Frequently Asked Questions about validate-skills

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

FAQPage Schema
How do I validate skill metadata against the agentskills.io spec?▼

Skill validation checks every skill directory in a repository to verify name, description, license, and metadata fields against agentskills.io rules. It enforces Claude Code best practices by applying structured checks and reporting non-conformant SKILL.md files.

What does a skill linter check in Claude Code repositories?▼

A skill linter checks Claude Code repositories by scanning all skill directories to verify that names, descriptions, licenses, and metadata conform to agentskills.io specification rules, enforcing consistency and producing actionable guidance for remediation.

Can I use this validator to check all skill directories in my repository?▼

Yes, you can use this validator to scan all skill directories in your repository. It applies structured checks to every skill directory under the repository to verify metadata conformance and reports any non-compliant SKILL.md files.

What's the best way to audit skill quality and fix non-conformant metadata?▼

The best way to audit skill quality is to run a validation tool that enforces the agentskills.io spec across all skill directories, identifying non-conformant metadata and generating actionable feedback to guide remediation of your SKILL.md files.

Why does my skill fail validation checks for agentskills compliance?▼

Your skill fails validation checks when its name, description, license, or metadata fields violate the defined agentskills.io specification rules. The validator reports these specific non-conformant fields with actionable feedback to help you remediate the issues.

Related Skills

Explore More Software Engineering Skills→
pradeepmoulipradeepmouli
2

speckit-baseline

Generate baseline-spec.md and current-state.md from repository analysis.

Community
Advanced
jackchukajackchuka
15

claude-skill-spec-audit

Validate SKILL.md frontmatter against the agentskills.io specification.

Community
Advanced
pacphipacphi
6

Verification & Quality Assurance

Score code and agent outputs with automated verification and rollback.

Community
Advanced
Clay-HHKClay-HHK
2

exploratory-data-analysis

Detect scientific file types and generate markdown EDA reports with quality metrics.

Community
Advanced