Files
Vjosa 7591d6d370 ci: agent skills ref CI validation (#85)
This PR adds upstream Agent Skills spec validation to the skills CI
workflow using `skills-ref` / `agentskills validate`.
The spec validator now checks each `skills/**/SKILL.md` for:
- valid `SKILL.md` YAML frontmatter
- closed YAML frontmatter
- frontmatter parses as a YAML mapping
- required `name` and `description` fields
- allowed top-level frontmatter fields only:
  - `name`
  - `description`
  - `license`
  - `allowed-tools`
  - `metadata`
  - `compatibility`
- `name` is a non-empty string
- `name` is max 64 characters
- `name` is lowercase
- `name` contains only alphanumeric characters and hyphens
- `name` does not start or end with a hyphen
- `name` does not contain consecutive hyphens
- `name` matches the parent skill directory
- `description` is a non-empty string
- `description` is max 1024 characters
- optional `compatibility` is a string
- optional `compatibility` is max 500 characters
The existing `scripts/verify-skills.sh` remains responsible for
cx-cli-specific checks such as trigger coverage, command references,
related skill links, max 400-line `SKILL.md` size, and shared-reference
sync.

## Notes
To comply with the upstream Agent Skills spec, skill versions were moved
from top-level `version:` into `metadata.version`.
## Validation
- Ran `agentskills validate` for all `skills/**/SKILL.md`
- Ran `bash scripts/verify-skills.sh`
2026-05-07 12:40:37 +03:00
..