skill-validator

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

2|1|Updated Jan 25, 2026

Search Tags:#documentation #skills #validate #lint #CI #AGENTS.md #agentskills.io

Ready to run

npx skills add https://github.com/jorgealves/agent_skills --skill skill-validator-jorgealves

💬 Prompt for ChatGPT / Claude Chat▼

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.