Summary
SkillCard has a JSON Schema at schemas/skillcard.schema.json
that powers skillctl validate and enables IDE autocompletion.
SkillCollection YAML has no equivalent schema — there's no
validation beyond Go struct unmarshaling.
Proposed solution
Add schemas/skillcollection.schema.json covering:
Extend skillctl validate to detect collection files
(by kind: SkillCollection) and validate against the
collection schema.
Motivation
References
- Existing schema:
schemas/skillcard.schema.json
- Collection implementation:
pkg/collection/
Summary
SkillCard has a JSON Schema at
schemas/skillcard.schema.jsonthat powers
skillctl validateand enables IDE autocompletion.SkillCollection YAML has no equivalent schema — there's no
validation beyond Go struct unmarshaling.
Proposed solution
Add
schemas/skillcollection.schema.jsoncovering:apiVersion(required, must beskillimage.io/v1alpha1)kind(required, must beSkillCollection)metadata.name,metadata.version,metadata.descriptionskills[]entries withref(andsourceonce feat: support Git source URLs in collection YAML for development workflow #35 lands)Extend
skillctl validateto detect collection files(by
kind: SkillCollection) and validate against thecollection schema.
Motivation
References
schemas/skillcard.schema.jsonpkg/collection/