Skills API

Public Endpoints


GET /api/v1/public/skills?type=trading&search=btc&page=1&page_size=20


GET /api/v1/public/skills/{slug}


GET /api/v1/skills/{slug}/files

Returns the source files of a Skill’s latest published version (SKILL.md, runtime YAML, Python scripts).


GET /api/v1/public/official-skills/{skill_id}/skill.md

Returns the SKILL.md for official/first-party Skills as plain text Markdown. No authentication required.


POST /api/v1/user/skills
Content-Type: multipart/form-data

Fields: name, description, type, pricing, tags, file (tar.gz)


GET /api/v1/user/skills


POST /api/v1/user/skills/{skill_id}/versions
Content-Type: multipart/form-data


POST /api/v1/skills/{skill_id}/execute

Used for skill-side execution flows and integration testing paths.


POST /api/v1/user/skills/{slug}/ratings
Body: {"rating": 5, "comment": "Great strategy!"}