Validate & Fix Agent Skills
Purpose
This skill provides an autonomous loop for identifying and fixing validation issues in Agent Skills using make validate. Use this when you need to ensure all skills in the repository adhere to the Agent Skills Specification.
Loop Logic
- Validate: Run
make validateto check all Agent Skills. - Analyze: For any failures reported:
- Examine the error message and the failing SKILL.md or directory structure. - Identify the specific validation rule being violated (e.g., missing frontmatter, unsupported fields).
- Fix: Apply the necessary changes to the failing skill.
- Verify: Re-run
make validate.
- If passed: Move to next issue or terminate if all pass. - If failed: Analyze the new failure and repeat the loop.
Termination Criteria
- No more errors reported by
make validate. - Reached max iteration limit (default: 5).
Common Commands
| Task | Command |
|---|---|
| Validate all skills | make validate |
| Validate via script | bash dev/validate_skills.sh |
Examples
Scenario: Fixing Frontmatter Errors
make validatereportsUnexpected fields in frontmatter: argument-hintinskills/tf-debug/SKILL.md.- Agent removes the unsupported
argument-hintfield fromskills/tf-debug/SKILL.md. make validatepasses for all skills.