Skills

Import a skill bundle

Changed on

Uploads a zip archive containing a SKILL.md file and optional supporting files. Creates a new file-bearing skill. An existing display name returns AlreadyExists. Operating-system archive metadata is ignored: __MACOSX entries, AppleDouble sidecars (._*), and per-directory metadata such as .DS_Store, Thumbs.db, and desktop.ini are dropped and do not count toward the per-skill file limit.

post/v2/skills/import

Request

Request body

project_idstring

Project that should contain the skill when creating a new skill. Import creates a new skill; a conflicting name returns AlreadyExists.

pathstring

Project path where the new skill should be stored.

bundlestring bytes required

Zip archive containing SKILL.md at the root and optional supporting files. In JSON requests the bytes are base64 encoded. Operating-system archive metadata (__MACOSX, ._* AppleDouble sidecars, .DS_Store, Thumbs.db, desktop.ini) is ignored.

Response

OK

Changes