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.
How do I install this agent skill?
npx skills add https://github.com/jorgealves/agent_skills --skill skill-validatorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill-validator is a metadata-driven utility designed to lint and validate the structure of other AI agent skills. It contains no executable code, hardcoded secrets, or network capabilities, making it safe for use in development and CI/CD environments.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
2/2 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
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.yamlcannot be parsed, the validator will fail immediately with a syntax error. - Missing Required Fields: Any missing field defined in the
agentskills.iospecification will result inis_valid: false. - Empty Directories: Folders in
agent-skills/that do not contain askill.yamlwill 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/jorgealves/agent_skills/skill-validator">View skill-validator on skillZs</a>