Sign in
agentSkills

Returns all skills.

Returns one page of shared skills available to the requesting user. Pages contain at most 1000 skills. Use page and pageSize query parameters; pagination metadata is returned in aw-* headers.

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

get/agents/skills

Query parameters

pageinteger

Page number for pagination

pageSizeinteger

Number of items per page

orderbystring

The properties to order by

filterbystring

The filter expression to filter by

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