Skip to main content
POST
/
agent_skills
Python
from acontext import AcontextClient
from acontext.uploads import FileUpload

client = AcontextClient(api_key='sk_project_token')

# Upload a skill from a zip file
with open('my_skill.zip', 'rb') as f:
    skill = client.skills.create(
        file=FileUpload(filename='my_skill.zip', content=f.read(), content_type='application/zip'),
        user='[email protected]',
        meta={'version': '1.0'}
    )
print(f"Created skill: {skill.name} (ID: {skill.id})")
{
  "code": 123,
  "error": "<string>",
  "msg": "<string>",
  "data": {
    "created_at": "<string>",
    "description": "<string>",
    "disk_id": "<string>",
    "file_index": [
      {
        "mime": "<string>",
        "path": "<string>"
      }
    ],
    "id": "<string>",
    "meta": {},
    "name": "<string>",
    "updated_at": "<string>",
    "user_id": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Project Bearer token (e.g., "Bearer sk-ac-xxxx")

Body

multipart/form-data
file
file
required

ZIP file containing agent skill. Must contain SKILL.md (case-insensitive) with YAML format: name and description fields.

user
string

User identifier to associate with the skill

meta
string

Additional metadata (JSON string)

Response

201 - application/json

Returns agent skill with name and description extracted from SKILL.md

code
integer
error
string
msg
string
data
object