agent-skills

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

Tools

Tool	Description
`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_get`	Get a single agent skill by ID. Returns the full skill details including content.
`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_update`	Update an existing agent skill. Provide the skill ID, the updated fields, and the current version number for optimistic concurrency.
`agent_skills_delete`	Delete an agent skill by ID. This is a soft delete.

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

Show inputSchema

{
  "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"
  ]
}

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

Show inputSchema

{
  "type": "object",
  "properties": {
    "skillId": {
      "type": "string",
      "description": "The ID of the skill to retrieve"
    }
  },
  "required": [
    "skillId"
  ]
}

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 Agent. Can include both.

Show inputSchema

{
  "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 Agent. Can include both."
    }
  },
  "required": [
    "name",
    "description",
    "content",
    "ownerType",
    "types"
  ]
}

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)

Show inputSchema

{
  "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"
  ]
}

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

Show inputSchema

{
  "type": "object",
  "properties": {
    "skillId": {
      "type": "string",
      "description": "The ID of the skill to delete"
    }
  },
  "required": [
    "skillId"
  ]
}

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

Tools

agent_skills_list

agent_skills_get

agent_skills_create

agent_skills_update

agent_skills_delete

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

​Tools

​agent_skills_list

​agent_skills_get

​agent_skills_create

​agent_skills_update

​agent_skills_delete

Tools

agent_skills_list

agent_skills_get

agent_skills_create

agent_skills_update

agent_skills_delete