Marketplace API

The Skills Marketplace allows users to publish, discover, and share agent skills.

Browse Skills

GET /api/v1/marketplace/browse

List published skills with pagination and sorting.

Query parameters:

Parameter	Default	Description
sort	newest	Sort order: newest or popular
tags	—	Filter by tags (comma-separated)
limit	50	Max results per page
offset	0	Pagination offset

Response:

{
  "items": [
    {"name": "code-review", "author": "user-uuid", "description": "...", "tags": ["code"], "downloads": 42, "version": "1.0"}
  ],
  "total": 15,
  "limit": 50,
  "offset": 0,
  "has_more": false
}

Search Skills

GET /api/v1/marketplace/search?q=QUERY

Search by name or description.

Skill Detail

GET /api/v1/marketplace/detail/:name

Get full skill detail including body. Use ?author=<uuid> for disambiguation.

Response:

{
  "name": "code-review",
  "author": "user-uuid",
  "description": "Reviews code for bugs",
  "tags": ["code", "review"],
  "body": "skill content...",
  "downloads": 42,
  "created_at": 1745600000000
}

Publish Skill

POST /api/v1/marketplace/publish

Publish a skill. Auth required. Rate limited to 10 publishes per hour.

Request body:

{
  "name": "my-skill",
  "description": "Short description",
  "tags": ["tag1", "tag2"],
  "body": "Full SKILL.md content (max 4096 chars)"
}

Reserved names (search, reports, dismiss, feature, rate, ratings) are rejected.

Delete Skill

DELETE /api/v1/marketplace/delete/:name

Delete a published skill. Author or admin only.

Report Skill

POST /api/v1/marketplace/report/:name

Report a skill for moderation. Auth required.

Request body: {"reason": "description of issue"}

Admin: Reports

GET /api/v1/marketplace/reports

List pending reports. Admin only.

Admin: Dismiss Report

POST /api/v1/marketplace/dismiss/:name

Dismiss a report. Admin only.