文档
技能接口
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/skills | 技能列表（is_active / library_folder_id / 分页） |
| POST | /api/skills | 创建技能（可带 package_* / source_*） |
| GET | /api/skills/:id | 技能详情 |
| PATCH | /api/skills/:id | 更新技能 |
| DELETE | /api/skills/:id | 删除技能 |
| GET | /api/skills/search | 搜索技能 |
| GET/POST | /api/skills/sync | 增量拉取 / 批量推送 |
| POST | /api/skills/upload-zip | multipart 上传 ZIP → OSS，返回包元数据 |
| POST | /api/skills/remote/preview | 预览远程仓库中的 skills |
| POST | /api/skills/remote/install | 从远程仓库安装到个人库 |
| GET | /api/skills/:id/install | 稳定 Install URL（zip|md，给 CLI / Agent） |
| POST | /api/skills/:id/install-token | 签发私有安装链接 |
| GET | /api/gallery/items/:id/install | Discover 公开技能安装（zip|md） |
| GET | /api/doubao-skill | PromptMan 管家包（豆包电脑版） |
创建技能（POST /api/skills）
| 字段 | 必填 | 说明 |
|---|---|---|
| name | ✅ | 技能名称 |
| description / version / accent / skill_md | ❌ | 说明、版本、颜色、SKILL.md 正文 |
| is_public / is_active / platforms / tags | ❌ | 可见性与标签 |
| packageUrl / packageKey / fileTree / fileContents | ❌ | ZIP 上传后回写的包字段 |
| source_type / source_ref / source_skill / source_commit | ❌ | 远程安装溯源 |
ZIP 上传
bash
curl -X POST https://prompt.solokit.run/api/skills/upload-zip \ -H "Authorization: Bearer ph_your_token" \ -F "file=@./my-skill.zip" \ -F "skillId=sk_optional_id"
远程安装
bash
curl -X POST https://prompt.solokit.run/api/skills/remote/preview \
-H "Authorization: Bearer ph_your_token" \
-H "Content-Type: application/json" \
-d '{"source":"owner/repo"}'
curl -X POST https://prompt.solokit.run/api/skills/remote/install \
-H "Authorization: Bearer ph_your_token" \
-H "Content-Type: application/json" \
-d '{"source":"owner/repo","duplicateStrategy":"skip"}'Install URL
bash
npx skills add https://prompt.solokit.run/api/skills/sk_xxx/install npx skills add https://prompt.solokit.run/api/gallery/items/<id>/install
CAUTION
私有技能的 Install URL 需 ?t= 签名或所有者 Bearer；不要把 Dashboard 页面 URL 交给 CLI。