Imports a skill package.

POST

https://api.awork.com/api/v1/agents/skills/import

POST

/api/v1/agents/skills/import

curl -X POST https://api.awork.com/api/v1/agents/skills/import \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: multipart/form-data" \
     -F content=@"[object Object]" \
     -F file=@"[object Object]" \
     -F fileName='{
  "type": "json"
}'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "createdBy": "123e4567-e89b-12d3-a456-426614174000",
  "createdOn": "2024-01-15T09:30:00Z",
  "updatedOn": "2024-01-15T09:30:00Z",
  "key": "string",
  "name": "string",
  "description": "string",
  "instructions": "string",
  "instructionsSource": "string",
  "type": "user",
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "accessLevel": "read",
  "isOwner": true,
  "workspaceAccessLevel": "read",
  "linkedAgentCount": 1,
  "metadata": "string",
  "hasFiles": true,
  "secretRequirements": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "envVarName": "string",
      "description": "string",
      "scope": "workspace",
      "isRequired": true,
      "hasValue": true
    }
  ]
}

Imports a skill from an agentskills.io ZIP package or standalone SKILL.md file. Pass agentId to import the skill as private to that agent; omit it to create a reusable skill.

Required Permissions

Any authenticated user.

Imports a skill from an agentskills.io ZIP package or standalone SKILL.md file. Pass agentId to import the skill as private to that agent; omit it to create a reusable skill. <Check title="Required Permissions" icon="key">Any authenticated user.</Check>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

agentIdstringOptionalformat: "uuid"

The optional owning agent ID.

Request

This endpoint expects a multipart form with multiple files.

filefileOptional

An agentskills.io ZIP package or standalone SKILL.md file.

contentfileOptional

Standalone SKILL.md content used by agent and MCP callers.

fileNamestringOptional

The file name used when content is supplied, for example SKILL.md.

Response

idstringOptionalformat: "uuid"

The skill identifier.

createdBystringOptionalformat: "uuid"

The user who created the skill.

createdOnstringOptionalformat: "date-time"

When the skill was created.

updatedOnstring or nullOptionalformat: "date-time"

When the skill was last updated.

keystring or nullOptional

The stable key used to reference the skill.

namestring or nullOptional

The name shown in the skill library.

descriptionstring or nullOptional

A short explanation of what the skill does.

instructionsstring or nullOptional

The Markdown instruction body from SKILL.md.

instructionsSourcestring or nullOptional

The source from which the instructions were created.

typeenumOptional

The ownership type.

userIdstring or nullOptionalformat: "uuid"

The owning user for a user-owned skill.

agentIdstring or nullOptionalformat: "uuid"

The owning agent for an agent-owned skill.

accessLevelenumOptional

The requesting user's resolved access level.

isOwnerbooleanOptional

Whether the requesting user owns the skill.

workspaceAccessLevelenum or nullOptional

The workspace-wide access level.

linkedAgentCountintegerOptional

The number of linked agents.

metadatastring or nullOptional

The skill frontmatter as a JSON object.

hasFilesbooleanOptional

Whether the skill includes bundled files.

secretRequirementslist of objects or nullOptional

The secrets that the skill declares.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error