| name | skill-validator |
| description | Validates agent skill definitions against agentskills.io and AGENTS.md rules. Use when creating or modifying skills to ensure they are machine-readable and documentation-complete. |
Skill Validator
Purpose and Intent
The skill-validator is the primary quality control tool for this repository. It ensures that every AI Agent Skill is "machine-consumable" by validating it against the agentskills.io standard and the repository's AGENTS.md rules.
When to Use
- During Development: Run this skill every time you create or modify a skill.
- CI/CD Integration: Automatically block Pull Requests that contain non-compliant skill definitions.
- Repository Audits: Periodically scan the entire
agent-skills/ directory to ensure long-term compliance as specifications evolve.
When NOT to Use
- Code Logic Validation: This tool does not "run" the skills or verify their internal logic; it only validates the "contract" (the YAML and Markdown).
Error Conditions and Edge Cases
- Invalid YAML: If
skill.yaml cannot be parsed, the validator will fail immediately with a syntax error.
- Missing Required Fields: Any missing field defined in the
agentskills.io specification will result in is_valid: false.
- Empty Directories: Folders in
agent-skills/ that do not contain a skill.yaml will be flagged as invalid skills.
Security and Data-Handling Considerations
- ReadOnly Access: The skill only requires read permissions for the target directory.
- No External Calls: Validation is performed locally using the embedded schema rules.