Sign in
customAgents

Lists agent skills.

Returns the skills linked to an agent after checking read access to the agent.

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

get/agents/{agentId}/skills

Path parameters

agentIdstring uuid required

The agent id.

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