Sign in
agentSkills

Creates a reusable skill.

Creates a user-owned skill and enables it when the creator may configure the awork Agent.

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

post/agents/skills

Request body

keystring nullable

The stable key used to reference the skill.

namestring nullable

The name shown in the skill library.

descriptionstring nullable

A short explanation of what the skill does.

instructionsstring required

The Markdown instruction body from SKILL.md.

instructionsSourcestring nullable

The source from which the instructions were created.

metadatastring nullable

The skill frontmatter as a JSON object.

Response

OK

idstring uuid

The skill identifier.

createdBystring uuid

The user who created the skill.

createdOnstring date-time

When the skill was created.

updatedOnstring date-time nullable

When the skill was last updated.

keystring nullable

The stable key used to reference the skill.

namestring nullable

The name shown in the skill library.

descriptionstring nullable

A short explanation of what the skill does.

instructionsstring nullable

The Markdown instruction body from SKILL.md.

instructionsSourcestring nullable

The source from which the instructions were created.

type'user' | 'agent'

The ownership type.

userIdstring uuid nullable

The owning user for a user-owned skill.

agentIdstring uuid nullable

The owning agent for an agent-owned skill.

accessLevel'read' | 'manage'

The requesting user's resolved access level.

isOwnerboolean

Whether the requesting user owns the skill.

workspaceAccessLevel'read' | 'manage'

The workspace-wide access level.

linkedAgentCountinteger

The number of linked agents.

metadatastring nullable

The skill frontmatter as a JSON object.

hasFilesboolean

Whether the skill includes bundled files.

Changes

Changed in 1 of the 11 revisions of this API.1