> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# agent skills

> List, create, update, and delete agent skills that guide agent behavior

**Server path:** `/agent-skills` | **Type:** Embedded | **PCID required:** No

## Tools

| Tool                                          | Description                                                                                                                                                                                                                               |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`agent_skills_create`](#agent_skills_create) | Create a new agent skill. Skills are instructions that agents discover and use when handling tasks. Specify ownerType="user" for a personal skill or ownerType="organization" for an org-wide skill (requires admin).                     |
| [`agent_skills_delete`](#agent_skills_delete) | Delete an agent skill by ID. This is a soft delete.                                                                                                                                                                                       |
| [`agent_skills_get`](#agent_skills_get)       | Get a single agent skill by ID. Returns the full skill details including content.                                                                                                                                                         |
| [`agent_skills_list`](#agent_skills_list)     | List agent skills by ownership scope. Returns skills owned by the current user (ownerType="user") or skills shared across the organization (ownerType="organization"). Use includeContent=true to get full skill content in the response. |
| [`agent_skills_update`](#agent_skills_update) | Update an existing agent skill. Provide the skill ID, the updated fields, and the current version number for optimistic concurrency.                                                                                                      |

***

## agent\_skills\_create

Create a new agent skill. Skills are instructions that agents discover and use when handling tasks. Specify ownerType="user" for a personal skill or ownerType="organization" for an org-wide skill (requires admin).

**Parameters:**

| Parameter     | Type      | Required | Default | Description                                                                                                                              |
| ------------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `name`        | string    | Yes      | —       | Skill name (e.g., "Email Guidelines")                                                                                                    |
| `description` | string    | Yes      | —       | Short description of what the skill teaches the agent (used for discovery matching)                                                      |
| `content`     | string    | Yes      | —       | The full skill content in markdown. This is the instruction text that agents will see and follow.                                        |
| `ownerType`   | string    | Yes      | —       | "user" for a personal skill, "organization" for an org-wide skill                                                                        |
| `types`       | string\[] | Yes      | —       | When this skill is available: "workflow-creation" for the Workflow Building Agent, "agent-execution" for the Coworker. Can include both. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "description": "Skill name (e.g., \"Email Guidelines\")"
      },
      "description": {
        "type": "string",
        "description": "Short description of what the skill teaches the agent (used for discovery matching)"
      },
      "content": {
        "type": "string",
        "description": "The full skill content in markdown. This is the instruction text that agents will see and follow."
      },
      "ownerType": {
        "type": "string",
        "enum": [
          "user",
          "organization"
        ],
        "description": "\"user\" for a personal skill, \"organization\" for an org-wide skill"
      },
      "types": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "workflow-creation",
            "agent-execution"
          ]
        },
        "description": "When this skill is available: \"workflow-creation\" for the Workflow Building Agent, \"agent-execution\" for the Coworker. Can include both."
      }
    },
    "required": [
      "name",
      "description",
      "content",
      "ownerType",
      "types"
    ]
  }
  ```
</Expandable>

***

## agent\_skills\_delete

Delete an agent skill by ID. This is a soft delete.

**Parameters:**

| Parameter | Type   | Required | Default | Description                   |
| --------- | ------ | -------- | ------- | ----------------------------- |
| `skillId` | string | Yes      | —       | The ID of the skill to delete |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "skillId": {
        "type": "string",
        "description": "The ID of the skill to delete"
      }
    },
    "required": [
      "skillId"
    ]
  }
  ```
</Expandable>

***

## agent\_skills\_get

Get a single agent skill by ID. Returns the full skill details including content.

**Parameters:**

| Parameter | Type   | Required | Default | Description                     |
| --------- | ------ | -------- | ------- | ------------------------------- |
| `skillId` | string | Yes      | —       | The ID of the skill to retrieve |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "skillId": {
        "type": "string",
        "description": "The ID of the skill to retrieve"
      }
    },
    "required": [
      "skillId"
    ]
  }
  ```
</Expandable>

***

## agent\_skills\_list

List agent skills by ownership scope. Returns skills owned by the current user (ownerType="user") or skills shared across the organization (ownerType="organization"). Use includeContent=true to get full skill content in the response.

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                          |
| ---------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------ |
| `ownerType`      | string  | Yes      | —       | Filter by owner type: "user" for personal skills, "organization" for org-wide skills |
| `includeContent` | boolean | No       | `false` | Whether to include the full skill content in the response                            |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "ownerType": {
        "type": "string",
        "enum": [
          "user",
          "organization"
        ],
        "description": "Filter by owner type: \"user\" for personal skills, \"organization\" for org-wide skills"
      },
      "includeContent": {
        "type": "boolean",
        "default": false,
        "description": "Whether to include the full skill content in the response"
      }
    },
    "required": [
      "ownerType"
    ]
  }
  ```
</Expandable>

***

## agent\_skills\_update

Update an existing agent skill. Provide the skill ID, the updated fields, and the current version number for optimistic concurrency.

**Parameters:**

| Parameter     | Type      | Required | Default | Description                                                              |
| ------------- | --------- | -------- | ------- | ------------------------------------------------------------------------ |
| `skillId`     | string    | Yes      | —       | The ID of the skill to update                                            |
| `name`        | string    | Yes      | —       | Updated skill name                                                       |
| `description` | string    | Yes      | —       | Updated skill description                                                |
| `content`     | string    | Yes      | —       | Updated skill content in markdown                                        |
| `types`       | string\[] | Yes      | —       | Updated skill types                                                      |
| `version`     | number    | Yes      | —       | Current version number of the skill (for optimistic concurrency control) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "skillId": {
        "type": "string",
        "description": "The ID of the skill to update"
      },
      "name": {
        "type": "string",
        "description": "Updated skill name"
      },
      "description": {
        "type": "string",
        "description": "Updated skill description"
      },
      "content": {
        "type": "string",
        "description": "Updated skill content in markdown"
      },
      "types": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "workflow-creation",
            "agent-execution"
          ]
        },
        "description": "Updated skill types"
      },
      "version": {
        "type": "number",
        "description": "Current version number of the skill (for optimistic concurrency control)"
      }
    },
    "required": [
      "skillId",
      "name",
      "description",
      "content",
      "types",
      "version"
    ]
  }
  ```
</Expandable>