The complete JSON schema reference for the shipables.json manifest file.
shipables.json Specification
The shipables.json file is the package manifest. It's required for publishing and must be in the skill's root directory alongside SKILL.md.
Schema
{
"version": "string (required, SemVer)",
"repository": "string (URL, optional)",
"homepage": "string (URL, optional)",
"keywords": ["string"],
"categories": ["string (category slug)"],
"icon": "string (file path, optional)",
"author": {
"name": "string",
"github": "string"
},
"mcp": {
"servers": [
{
"name": "string (required)",
"package": "string (required)",
"registry": "npm | pypi | generic (required)",
"version": "string (default: latest)",
"transport": "stdio | sse (required)",
"args": ["string"],
"env": ["string (env var names)"]
}
]
},
"config": {
"env": [
{
"name": "string (required)",
"description": "string (required)",
"required": "boolean (default: false)",
"secret": "boolean (default: false)",
"default": "string (optional)"
}
]
}
}