Agent-Skills.md

Agent Skills: Skill Validator

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.

UncategorizedID: jorgealves/agent_skills/skill-validator

Repository

jorgealves/agent_skills
jorgealvesLicense: GPL-3.0
1

Install this agent skill to your local

pnpm dlx add-skill https://github.com/jorgealves/agent_skills/tree/HEAD/skill-validator

Skill Files

Browse the full folder contents for skill-validator.

Download Skill

Loading file tree…

skill-validator/SKILL.md

Skill Metadata

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.