JSON Schema
Field reference for listing.json files. Download the full schema at /skill-schema.json.
| Field | Type | Req | Description |
|---|---|---|---|
name | string | Yes | Display name (2-100 chars) |
slug | string | — | URL identifier. Auto-generated from name if omitted |
description | string | Yes | Short description (10-300 chars) |
longDescription | string | — | Multi-paragraph description (max 5000 chars) |
type | string | — | "skill" | "mcp-server" | "agent". Default: "skill" |
category | string | Yes | code-review, testing, deployment, documentation, security, data-pipeline, devops, productivity, database, api, design |
sourceUrl | string | — | Public URL to source (GitHub, npm, etc.) |
sourceType | string | — | "github" | "npm" | "other". Default: "github" |
installCmd | string | — | Command users run to install (max 500 chars) |
compatibility | string | — | Comma-separated tools. Default: "claude-code" |
tags | string | — | Comma-separated keywords (max 500 chars) |
isFree | boolean | — | Default: true. Community listings are always free |
price | number | — | USD, minimum $0.99 (required if isFree is false) |
listingType | string | — | "original" | "community". Default: "original" |
originalAuthor | string | — | Original author name (for community listings) |
originalUrl | string | — | Original author URL (for community listings) |
skillContent | string | — | SKILL.md content delivered via CLI (max 100KB) |
files | array | — | Array of {filename, content} for multi-file skills |
dependencies | array | — | Array of slugs this skill depends on |