registry.schema.json — Registry index

For the registry API response (skills.json). Defines the skills index data structure.

Top-level fields:

FieldTypeRequiredDescription
updated_atstringYesISO 8601 timestamp of last update (e.g. 2026-07-17T12:00:00.000Z)
sourcesSourceEntry[]YesSkills grouped by source repository

SourceEntry (sources[]):

FieldTypeRequiredDescription
sourcestringYesSource name (e.g. org/repo)
urlstringNoSource repository URL
commit_hashstringNoLatest commit hash (SHA) of the source repository at sync time
skillsSkillEntry[]YesSkills available from this source

SkillEntry (sources[].skills[]):

FieldTypeRequiredDefaultDescription
namestringYesSkill name
pathstringYesPath to SKILL.md relative to repository root (e.g. skills/vue/SKILL.md or my-skill/SKILL.md for root-level skills)
descriptionstringNo""Skill description
versionstringNo""Skill version