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.

install

source · Clone the upstream repo

git clone https://github.com/jorgealves/agent_skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jorgealves/agent_skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skill-validator" ~/.claude/skills/jorgealves-agent-skills-skill-validator && rm -rf "$T"

manifest: skill-validator/SKILL.md

source content

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.