agentskills.io¶
These rules validate skills against the agentskills.io specification. They auto-enable for agentskills repos, single plugins, and marketplaces whenever skills are detected.
| Rule ID | Description | Default Severity | Autofix |
|---|---|---|---|
agentskill-valid |
SKILL.md must have valid frontmatter with name and description | error (auto) | auto |
agentskill-name |
Skill name must be lowercase letters, numbers, and hyphens and match directory name | error (auto) | auto |
agentskill-rename-refs |
Update stale skill name references after a rename | warning (auto) | auto |
agentskill-description |
Skill description should be meaningful and within length limits | warning (auto) | - |
agentskill-structure |
Skill directories should only contain recognized subdirectories (stricter than spec) | warning (disabled) | - |
agentskill-evals |
Validate evals/evals.json format when present | warning (auto) | - |
agentskill-evals-required |
Require evals/evals.json for each skill (opt-in) | warning (disabled) | - |
agentskill-unreferenced-files |
Every bundled skill file should be referenced from SKILL.md, directly or transitively | warning (auto) | - |