Agents / MCP

Read skill

Read the full playbook body of one Pipeline-owned first-party workspace skill by name. Returns its metadata, availability, version, and raw markdown content. Use this to inspect the skill before hosted execution or an external work-order claim. Read-only.

tools/callDeterministic operation

Parameters

workspaceIdOptional · string
Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
skillNameRequired · string
The skill name from frontmatter (e.g. dream-one-hundred, cold-email-write).
Request example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "read-skill",
    "arguments": {
      "skillName": "example"
    }
  }
}
Full input schema
Input schema
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "minLength": 1,
      "description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
    },
    "skillName": {
      "type": "string",
      "description": "The skill name from frontmatter (e.g. dream-one-hundred, cold-email-write)."
    }
  },
  "required": [
    "skillName"
  ]
}
See this operation inCLI REST API TypeScript SDK
MCP reference | Pipeline v2 preview