skill-md-validator

Validate skill.md files against the agent skill specification.

1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/severith-ai/skill-md-validator --skill skill-md-validator-severith-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-md-validator
Source: https://github.com/severith-ai/skill-md-validator/tree/main
Command: npx skills add https://github.com/severith-ai/skill-md-validator --skill skill-md-validator-severith-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates skill.md files against the agent skill specification to prevent publishing errors and misconfigurations.

Core Features & Use Cases

  • Validates required fields (name, version, description) and optional URLs
  • Checks body content for headings, code examples, and required sections
  • Produces structured results and supports local or remote skill.md inputs

Quick Start

Run skill-validate on a local or remote skill.md to verify conformance.

Frequently Asked Questions about skill-md-validator

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

FAQPage Schema
How do I validate a skill.md file against the agent skill specification?

To validate a skill.md file, run the validator on a local file path or remote URL to enforce required fields, check content structure, and return structured results for fixes.

What fields are required in a skill.md file to pass validation?

Skill.md validation requires the name, version, and description fields, while also checking body content for headings, code examples, and required sections per the spec.

Can I validate remote skill.md files using a URL?

Yes, skill.md validation supports both local file paths and remote URLs as inputs, fetching the content to verify conformance with the agent skill specification.

Why does my skill.md file fail validation before publishing?

Skill.md validation fails when required fields like name, version, or description are missing, or when body content lacks required headings and code examples per the spec.

Does skill.md validation check YAML frontmatter for semver compliance?

Skill.md validation enforces required fields including version, applying the agent skill specification to ensure YAML frontmatter structure and content meet publishing standards.

What is the best way to check skill.md structure for agent publishing errors?

The best way to check skill.md structure is running a validator that enforces required fields, verifies content sections, and outputs structured results to prevent misconfigurations.