shipables.json

The shipables.json file is the package manifest for your skill. It contains distribution metadata used by the registry for search, display, and installation.

Note: The skill's name, description, and license are defined in SKILL.md frontmatter, not here. SKILL.md holds identity and legal metadata as defined by the Agent Skills standard, while shipables.json holds registry-specific metadata like versioning, categories, and MCP server declarations.

Minimal example

{
  "version": "1.0.0",
  "keywords": ["postgres", "database"],
  "categories": ["databases"],
  "author": {
    "name": "Jane Smith",
    "github": "janesmith"
  }
}

Full example