GET
/api/skills列表 / 搜索 Skills
支持 tab、q、sort、page、pageSize。用于其他系统做列表展示与搜索。
示例：/api/skills?tab=trending&q=sql&sort=popularity&page=1&pageSize=20
OpenAPI
SkillMarket API
面向其他系统的公开 HTTP API。当前阶段无需 Token 认证，已开启 CORS（`Access-Control-Allow-Origin: *`）。完整契约见 OpenAPI 3.1。
Endpoints
POST
/api/skills上传 / 发布 Skill
multipart/form-data：name、description、package(zip，需含 SKILL.md)；可选 version/category/license/changelog。
示例：/api/skills
GET
/api/skills/{slug}Skill 详情
返回元数据、SKILL.md 全文与版本列表。
GET
/api/skills/{slug}/download-url获取下载链接
返回绝对 downloadUrl / 相对 downloadPath，不增加下载计数。可选 version。
GET
/api/skills/{slug}/download下载 Skill 包
流式返回 zip，并 downloads++。可直接用 download-url 返回的链接。
GET
/api/openapiOpenAPI 文档
默认 JSON；?format=yaml 返回 YAML。
Integration notes
- 列表场景调用
/api/skills，用返回的items渲染表格。 - 上传用
POST /api/skills（multipart：name、description、packagezip）。 - 搜索传
q；分类视图传tab=featured|official|new|trending。 - 详情页调用
/api/skills/{slug}。 - 下载前先调
/download-url拿链接，再请求downloadUrl获取 zip。 - 本期无鉴权；后续如加 Token，会在 OpenAPI
security中声明。