Skills

interface Skills

Manages hosted skills and immutable versions without executing their contents. Default implementations preserve source compatibility for custom clients.

Inheritors

Functions

Link copied to clipboard
open suspend fun createSkill(request: SkillUploadRequest, requestOptions: RequestOptions? = null): Skill

Uploads a skill directory or ZIP once. Every source is closed even on failure; uploads are not automatically retried.

Link copied to clipboard
open suspend fun createSkillVersion(id: SkillId, request: SkillVersionUploadRequest, requestOptions: RequestOptions? = null): SkillVersion

Uploads an immutable version once, closing all sources even on failure. Newly uploaded versions may briefly return 404 on retrieval.

Link copied to clipboard
open suspend fun deleteSkill(id: SkillId, requestOptions: RequestOptions? = null): Boolean

Deletes the skill and all its versions; returns false for HTTP 404.

Link copied to clipboard
open suspend fun deleteSkillVersion(id: SkillId, version: String, requestOptions: RequestOptions? = null): Boolean

Deletes a version by its version string; the API rejects deletion of a selected default.

Link copied to clipboard
open suspend fun downloadSkill(id: SkillId, requestOptions: RequestOptions? = null): ByteArray

Downloads the skill ZIP bundle as exact bytes. HTTP errors propagate.

Link copied to clipboard
open suspend fun downloadSkillVersion(id: SkillId, version: String, requestOptions: RequestOptions? = null): ByteArray

Downloads the specified version's ZIP as exact bytes. HTTP errors propagate.

Link copied to clipboard
open suspend fun retrieveSkill(id: SkillId, requestOptions: RequestOptions? = null): Skill?

Retrieves skill metadata, or null for HTTP 404.

Link copied to clipboard
open suspend fun retrieveSkillVersion(id: SkillId, version: String, requestOptions: RequestOptions? = null): SkillVersion?

Retrieves a version by its version string, or null for HTTP 404.

Link copied to clipboard
open suspend fun skillsPage(query: SkillListQuery = SkillListQuery(), requestOptions: RequestOptions? = null): PaginatedList<Skill>

Lists project skills with cursor metadata.

Link copied to clipboard
open suspend fun skillVersionsPage(id: SkillId, query: SkillVersionListQuery = SkillVersionListQuery(), requestOptions: RequestOptions? = null): PaginatedList<SkillVersion>

Lists immutable versions with version-resource cursor IDs.

Link copied to clipboard
open suspend fun updateSkillDefaultVersion(id: SkillId, request: SkillDefaultVersionRequest, requestOptions: RequestOptions? = null): Skill

Changes the default version pointer to an existing version string.