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	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	Delete an agent skill by ID. This is a soft delete.
agent_skills_get	Get a single agent skill by ID. Returns the full skill details including content.
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	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.

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

---

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

---

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