Skip to main content
GET
Get a skill

Authorizations

Authorization
string
header
required

A Parley API key.

Path Parameters

slug
string
required

The skill's slug.

Maximum string length: 64
Pattern: ^[a-z0-9][a-z0-9-]*$

Response

OK

id
string
required

The skill ID.

Minimum string length: 1
slug
string
required

The skill's folder name, chosen when the skill is created. It is how the skill is addressed, and the name the assistant loads it by.

name
string
required

The skill name, from its SKILL.md.

description
string
required

What the skill is for, from its SKILL.md.

scope
enum<string>
required

Who can use the skill. organization: everyone in the organization. personal: only the person who created it.

Available options:
organization,
personal
activation
enum<string>
required

When the skill is used. auto: Parley's assistant uses it whenever its description fits the task. on-demand: only when someone runs it, from a project's Run Skill list or by typing / in a message.

Available options:
auto,
on-demand
enabled
boolean
required

Whether the skill is on. Parley never uses a skill that is off.

createdAt
string<date-time>
required

When the skill was created.

updatedAt
string<date-time>
required

When the skill was last changed.

content
string
required

The skill's SKILL.md: YAML frontmatter with its name and description, then the instructions.

files
string[]
required

The documents bundled with the skill, as paths from its folder, such as references/engagement-letter.docx. The skill's .skill archive holds them.