Publishing

Three ways to publish a skill on Skill Shope.

1. Web form

Sign in and go to /publish. Fill in the fields and submit. Best for one-off listings.

2. JSON upload

Prepare a listing.json file and upload it on the publish page. All fields auto-fill. See the JSON Schema for the field reference.

{
  "name": "My Skill",
  "description": "What it does in one line.",
  "category": "productivity",
  "type": "skill",
  "sourceUrl": "https://github.com/you/your-skill",
  "sourceType": "github",
  "installCmd": "npx skillshope install my-skill",
  "compatibility": "claude-code,codex,cursor",
  "tags": "tag1,tag2",
  "isFree": true,
  "skillContent": "---\nname: my-skill\n---\n\nYour skill content..."
}

3. API (CI/CD)

Publish programmatically with an API key. Generate a key from your dashboard, then:

curl -X POST https://skillshope.com/api/publish \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d @listing.json

See the API Reference for details.

Listing types