mirror of
https://github.com/coralogix/cx-cli.git
synced 2026-09-14 16:15:45 +08:00
Vjosa
7591d6d370
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`