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.