Documentation

Skills API

Method	Path	Description
GET	/api/skills	List skills (is_active / library_folder_id / pagination)
POST	/api/skills	Create a skill (optional package_* / source_*)
GET	/api/skills/:id	Skill detail
PATCH	/api/skills/:id	Update skill
DELETE	/api/skills/:id	Delete skill
GET	/api/skills/search	Search skills
GET/POST	/api/skills/sync	Incremental pull / batch push
POST	/api/skills/upload-zip	Multipart ZIP → OSS; returns package metadata
POST	/api/skills/remote/preview	Preview skills in a remote repo
POST	/api/skills/remote/install	Install from a remote repo into your library
GET	/api/skills/:id/install	Stable Install URL (zip\|md, for CLI / Agents)
POST	/api/skills/:id/install-token	Mint a private install link
GET	/api/gallery/items/:id/install	Discover public skill install (zip\|md)
GET	/api/doubao-skill	PromptMan manager package for Doubao Desktop

Create skill (POST /api/skills)

Field	Required	Description
name	✅	Skill name
description / version / accent / skill_md	❌	Meta, color, SKILL.md body
is_public / is_active / platforms / tags	❌	Visibility and tags
packageUrl / packageKey / fileTree / fileContents	❌	Fields returned from ZIP upload
source_type / source_ref / source_skill / source_commit	❌	Remote-install provenance

ZIP upload

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"

Remote install

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

Private Install URLs need a signed ?t= or owner Bearer. Never pass Dashboard page URLs to the CLI.

Error Codes Account