Skip to content

feat: expand skill validation to cover full Agent Skills spec#15

Merged
raiderrobert merged 5 commits into
mainfrom
feat/full-skill-validation
Mar 14, 2026
Merged

feat: expand skill validation to cover full Agent Skills spec#15
raiderrobert merged 5 commits into
mainfrom
feat/full-skill-validation

Conversation

@raiderrobert

Copy link
Copy Markdown
Owner

Summary

  • Replace validate-skill-descriptions.sh with validate-skills.sh covering the full Agent Skills spec
  • Validates: name (required, max 64 chars, lowercase+hyphens, no leading/trailing/consecutive hyphens, must match directory), description (required, max 1024 chars), compatibility (max 500 chars if present), SKILL.md existence, body length warning at 500+ lines
  • Each skill and each check is printed for visibility

Test plan

  • All 4 current skills pass validation
  • Invalid name (uppercase, consecutive hyphens) caught
  • Empty description caught
  • Directory name mismatch caught
  • Verify GitHub Actions workflow runs on this PR

Replace the description-only check with comprehensive validation per
the agentskills.io specification:

- name: required, max 64 chars, lowercase+hyphens only, no leading/
  trailing/consecutive hyphens, must match directory name
- description: required, non-empty, max 1024 chars
- compatibility: max 500 chars if present
- SKILL.md must exist in each skill directory
- body over 500 lines triggers a warning
- Upgrade actions/checkout v4 → v6
- Replace extractions/setup-just with direct install (its dependency
  setup-crate is stuck on Node 20)
- Upgrade action-semantic-pull-request v5 → v6
just isn't pre-installed on ubuntu-latest, so keep setup-just action
and opt into Node 24 to suppress deprecation warnings.
@raiderrobert raiderrobert merged commit 102d4b0 into main Mar 14, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant