OpenAPI

SkillMarket API

面向其他系统的 HTTP API。GET 列表/详情/下载公开；上传需 Bearer API Token（登录后在 /account/tokens 颁发或吊销）。已开启 CORS（含 `Authorization`）。完整契约见 OpenAPI 3.1。

Endpoints

GET/api/skills

支持 tab、q、sort、page、pageSize。用于其他系统做列表展示与搜索。

POST/api/skills

multipart/form-data：name、description、package(zip，需含 SKILL.md)；可选 version/category/license/changelog。请求头需 Authorization: Bearer <token>。

GET/api/skills/{slug}

返回元数据、SKILL.md 全文与版本列表。

GET/api/skills/{slug}/download-url

返回绝对 downloadUrl / 相对 downloadPath，不增加下载计数。可选 version。

GET/api/skills/{slug}/download

流式返回 zip，并 downloads++。默认最新；可选 `?version=1.0.0` 下载历史版本。

GET/api/openapi

默认 JSON；?format=yaml 返回 YAML。

GET/api/agent-kit

下载 skillmarket-openapi 包（SKILL.md + references），供 Claude Code / Cursor 等一键接入本市场。

GET/api/agent-kit/install.sh

curl | bash 安装到 ~/.claude/skills 与 ~/.cursor/skills。

GET/api/agent-kit/install.ps1

PowerShell irm | iex 安装到用户目录 skills 路径。

列表场景调用 /api/skills，用返回的 items 渲染表格。
上传用 POST /api/skills（multipart：name、description、package zip），并带Authorization: Bearer <token>。
登录后到 /account/tokens 创建 Token；泄露后可吊销并重建，吊销后立即 401。
搜索传 q；分类视图传 tab=featured|official|new|trending。
详情页调用 /api/skills/{slug}。
下载前先调 /download-url 拿链接，再请求 downloadUrl获取 zip。