skill-validator

Validates skill definitions against agentskills.io and AGENTS.md requirements.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures every AI Agent Skill remains compliant with the agentskills.io standards and the repository's AGENTS.md rules, guaranteeing machine-consumable definitions and complete documentation.

Core Features & Use Cases

  • Schema and field validation: Verifies YAML frontmatter includes required fields like name and description and checks for proper formatting.
  • Documentation validation: Ensures README/linked docs exist and conform to guidance for clear, consistent skills.
  • Repository governance: Enables CI/CD gates and periodic audits to maintain long-term compliance as skills evolve.

Quick Start

Run the skill-validator on the skill directory to verify YAML integrity, field presence, and documentation compliance.

Frequently Asked Questions about skill-validator

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

FAQPage Schema
How do I validate AI agent skills for AGENTS.md compliance in CI?

To validate AI agent skills for AGENTS.md compliance in CI, run a skill-validator on the skill directory to verify YAML frontmatter schema correctness, required field presence, and documentation completeness without executing skill logic.

What is agentskills.io schema validation for machine-consumable skills?

Agentskills.io schema validation for machine-consumable skills is the process of verifying that YAML frontmatter includes required fields like name and description, ensuring definitions remain machine-readable and properly formatted according to repository governance rules.

How do I lint skill documentation and YAML frontmatter during development?

To lint skill documentation and YAML frontmatter during development, apply a skill-validator to check for proper formatting, verify required fields exist, and ensure linked README documents conform to agentskills.io guidance for clear, consistent skills.

Can I use skill validation for repository audits without executing skill logic?

Yes, you can use skill validation for repository audits without executing skill logic, as the skill-validator enforces schema correctness, required frontmatter fields, and documentation completeness strictly through static analysis.

Do I need dependencies to check skill definitions against agentskills.io standards?

No, you do not need dependencies to check skill definitions against agentskills.io standards, because the skill-validator operates with no external dependencies to verify YAML integrity, field presence, and documentation compliance.

Why does my skill validation fail when linked documentation is missing?

Skill validation fails when linked documentation is missing because the skill-validator enforces documentation completeness by ensuring README and linked docs exist and conform to guidance for clear, consistent, machine-consumable skills.