Files
skillshare/schemas/registry.schema.json
T
Willie 19d88ce905 chore: update schema and red team scripts for centralized metadata
- registry.schema.json: describe .metadata.json store format (version,
  entries map with full field set) instead of old registry.yaml format
- Red team scripts: add write_store_meta helper, replace sidecar writes
  with centralized store writes in phase3 (integrity) and phase5 (advanced)
2026-04-08 17:43:39 +08:00

94 lines
3.3 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/runkids/skillshare/main/schemas/registry.schema.json",
"title": "Skillshare Metadata Store",
"description": "Centralized metadata store for skillshare — tracks installed skills and agents. Location: ~/.config/skillshare/skills/.metadata.json (global) or .skillshare/skills/.metadata.json (project). Auto-managed; manual edits are preserved on reconciliation.",
"type": "object",
"additionalProperties": false,
"properties": {
"version": {
"type": "integer",
"description": "Schema version. Currently 1.",
"const": 1
},
"entries": {
"type": "object",
"description": "Map of skill/agent relative paths to their metadata entries.",
"additionalProperties": {
"$ref": "#/$defs/metadataEntry"
}
}
},
"required": ["version", "entries"],
"$defs": {
"metadataEntry": {
"type": "object",
"description": "Metadata for an installed skill or agent.",
"properties": {
"source": {
"type": "string",
"description": "Original source input (GitHub path, local path, etc.).",
"examples": ["github.com/anthropics/skills/skills/pdf", "github.com/team/agents"]
},
"kind": {
"type": "string",
"description": "Resource kind. Empty or omitted defaults to 'skill'.",
"enum": ["", "skill", "agent"]
},
"type": {
"type": "string",
"description": "Source type (github, local, git-https, git-ssh, etc.)."
},
"tracked": {
"type": "boolean",
"description": "True if installed with --track (preserves git history).",
"default": false
},
"group": {
"type": "string",
"description": "Subdirectory group the resource belongs to (set by --into).",
"examples": ["frontend", "backend", "team/frontend"]
},
"branch": {
"type": "string",
"description": "Git branch to clone from. Omit for remote default branch."
},
"into": {
"type": "string",
"description": "Original --into value used during install."
},
"installed_at": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp of when the resource was installed."
},
"repo_url": {
"type": "string",
"description": "Git clone URL for the source repository.",
"examples": ["https://github.com/anthropics/skills.git"]
},
"subdir": {
"type": "string",
"description": "Subdirectory within the repo (for monorepo installs)."
},
"version": {
"type": "string",
"description": "Git commit hash at install/update time."
},
"tree_hash": {
"type": "string",
"description": "Git tree SHA of the subdir at install time."
},
"file_hashes": {
"type": "object",
"description": "Map of relative file paths to sha256:<hex> digests for integrity verification.",
"additionalProperties": {
"type": "string",
"pattern": "^sha256:[0-9a-f]{64}$"
}
}
}
}
}
}