# 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.

- Skill: `jorgealves/skill-validator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add jorgealves/skill-validator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jorgealves/skill-validator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: jorgealves (https://skillmd.com/u/jorgealves)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/jorgealves/skill-validator

---

# 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.