# Skills

## List

**get** `/api/promptly/skills`

Retrieve all skills for the organization

### Query Parameters

- `organizationId: string`

### Returns

- `id: string`

- `content: string`

  Markdown instructions that guide task execution

- `name: string`

- `category: optional string`

- `createdAt: optional string`

- `description: optional string`

- `frontmatter: optional object { author, requiredSources, tags }`

  Skill metadata

  - `author: optional string`

  - `requiredSources: optional array of string`

    Source slugs this skill depends on

  - `tags: optional array of string`

- `iconUrl: optional string`

- `isPublic: optional boolean`

  Whether the skill is shared publicly

- `isUserInvocable: optional boolean`

  Whether users can manually attach this skill

- `organizationId: optional string`

- `slug: optional string`

  URL-friendly identifier

- `updatedAt: optional string`

- `version: optional number`

### Example

```http
curl https://0ct.com/api/promptly/skills \
    -H "Authorization: Bearer $0CT_API_KEY"
```

## Create

**post** `/api/promptly/skills`

Create a new reusable instruction set

### Body Parameters

- `content: string`

- `name: string`

- `organizationId: string`

- `category: optional string`

- `description: optional string`

- `frontmatter: optional unknown`

- `iconUrl: optional string`

- `isPublic: optional boolean`

- `slug: optional string`

### Returns

- `Skill = object { id, content, name, 11 more }`

  - `id: string`

  - `content: string`

    Markdown instructions that guide task execution

  - `name: string`

  - `category: optional string`

  - `createdAt: optional string`

  - `description: optional string`

  - `frontmatter: optional object { author, requiredSources, tags }`

    Skill metadata

    - `author: optional string`

    - `requiredSources: optional array of string`

      Source slugs this skill depends on

    - `tags: optional array of string`

  - `iconUrl: optional string`

  - `isPublic: optional boolean`

    Whether the skill is shared publicly

  - `isUserInvocable: optional boolean`

    Whether users can manually attach this skill

  - `organizationId: optional string`

  - `slug: optional string`

    URL-friendly identifier

  - `updatedAt: optional string`

  - `version: optional number`

### Example

```http
curl https://0ct.com/api/promptly/skills \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $0CT_API_KEY" \
    -d '{
          "content": "content",
          "name": "name",
          "organizationId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
        }'
```

## Retrieve

**get** `/api/promptly/skills/{skillId}`

Get a skill

### Path Parameters

- `skillId: string`

### Returns

- `Skill = object { id, content, name, 11 more }`

  - `id: string`

  - `content: string`

    Markdown instructions that guide task execution

  - `name: string`

  - `category: optional string`

  - `createdAt: optional string`

  - `description: optional string`

  - `frontmatter: optional object { author, requiredSources, tags }`

    Skill metadata

    - `author: optional string`

    - `requiredSources: optional array of string`

      Source slugs this skill depends on

    - `tags: optional array of string`

  - `iconUrl: optional string`

  - `isPublic: optional boolean`

    Whether the skill is shared publicly

  - `isUserInvocable: optional boolean`

    Whether users can manually attach this skill

  - `organizationId: optional string`

  - `slug: optional string`

    URL-friendly identifier

  - `updatedAt: optional string`

  - `version: optional number`

### Example

```http
curl https://0ct.com/api/promptly/skills/$SKILL_ID \
    -H "Authorization: Bearer $0CT_API_KEY"
```

## Update

**patch** `/api/promptly/skills/{skillId}`

Update a skill

### Path Parameters

- `skillId: string`

### Body Parameters

- `category: optional string`

- `content: optional string`

- `description: optional string`

- `frontmatter: optional unknown`

- `isPublic: optional boolean`

- `name: optional string`

### Returns

- `Skill = object { id, content, name, 11 more }`

  - `id: string`

  - `content: string`

    Markdown instructions that guide task execution

  - `name: string`

  - `category: optional string`

  - `createdAt: optional string`

  - `description: optional string`

  - `frontmatter: optional object { author, requiredSources, tags }`

    Skill metadata

    - `author: optional string`

    - `requiredSources: optional array of string`

      Source slugs this skill depends on

    - `tags: optional array of string`

  - `iconUrl: optional string`

  - `isPublic: optional boolean`

    Whether the skill is shared publicly

  - `isUserInvocable: optional boolean`

    Whether users can manually attach this skill

  - `organizationId: optional string`

  - `slug: optional string`

    URL-friendly identifier

  - `updatedAt: optional string`

  - `version: optional number`

### Example

```http
curl https://0ct.com/api/promptly/skills/$SKILL_ID \
    -X PATCH \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $0CT_API_KEY" \
    -d '{}'
```

## Delete

**delete** `/api/promptly/skills/{skillId}`

Delete a skill

### Path Parameters

- `skillId: string`

### Example

```http
curl https://0ct.com/api/promptly/skills/$SKILL_ID \
    -X DELETE \
    -H "Authorization: Bearer $0CT_API_KEY"
```

## Domain Types

### Skill

- `Skill = object { id, content, name, 11 more }`

  - `id: string`

  - `content: string`

    Markdown instructions that guide task execution

  - `name: string`

  - `category: optional string`

  - `createdAt: optional string`

  - `description: optional string`

  - `frontmatter: optional object { author, requiredSources, tags }`

    Skill metadata

    - `author: optional string`

    - `requiredSources: optional array of string`

      Source slugs this skill depends on

    - `tags: optional array of string`

  - `iconUrl: optional string`

  - `isPublic: optional boolean`

    Whether the skill is shared publicly

  - `isUserInvocable: optional boolean`

    Whether users can manually attach this skill

  - `organizationId: optional string`

  - `slug: optional string`

    URL-friendly identifier

  - `updatedAt: optional string`

  - `version: optional number`