Sign in
agentSkills

Returns a skill.

Returns one skill when the caller has read access directly or through the optional linked agent.

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

get/agents/skills/{skillId}

Path parameters

skillIdstring uuid required

The skill ID.

Query parameters

agentIdstring uuid

The optional linked agent through which read access is requested.

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