SymDocs
Passes MCP
All productsSym Workspace APISym Passes MCP
Supportjoinsym.com ↗
Sym Passes MCP

sym_skill_run

Execute an exact published skill version on an explicitly chosen full-scope Browser Pass, profile and tab. For a reserved window supply top-level workSessionId from that same Pass/profile; do not release the session to run a skill. First read sym_skills action=get includeSource=false for the exact version and required inputSchema; then supply matching input. Invalid input never dispatches. target_window_busy is a server window lock; inspect the earlier outcome. Unreserved stalls can use recoverWindow on the reported tab with explicit reload consent. Published extension 0.1.29 cannot automatically reset a genuinely stalled reserved work session; stop and report that limitation instead of retrying or dropping its reservation. Loads verified immutable JavaScript server-side and invokes existing native eval; prefer this to copying source into a tool call. Requires current capabilityRevision from sym_pass_docs. Preserves original visual feedback and tab activation. May change browser/site data; explicit task authorization required. No automatic retries. Skill read labels are not a sandbox.

API 2.3.3 · Published service contract ↗

Permissions

Discovery scopes: skills:read, browser:read, browser:act. Requires configured catalogue service and discoveryScopes.

Arguments

FieldTypeRequiredDescription
catalogueIdstring✓
skillIdstring✓
versionstring✓
includeSourceboolean×Default: true
passIdstring✓
requestIdstring✓
profilestring✓
tabIdinteger✓
workSessionIdstring×Session returned by workWindow/beginWorkSession on this same Pass/profile. Keep the reservation while running the skill. Omit only for an unreserved tab.
capabilityRevisionstring✓
inputobject×Default: {}
Complete input schema
{
  "type": "object",
  "properties": {
    "catalogueId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.-]{1,128}$"
    },
    "skillId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.-]{1,128}$"
    },
    "version": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.-]{1,128}$"
    },
    "includeSource": {
      "default": true,
      "type": "boolean"
    },
    "passId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.-]{1,128}$"
    },
    "requestId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.-]{1,128}$"
    },
    "profile": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "tabId": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "workSessionId": {
      "description": "Session returned by workWindow/beginWorkSession on this same Pass/profile. Keep the reservation while running the skill. Omit only for an unreserved tab.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "capabilityRevision": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "input": {
      "default": {},
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "catalogueId",
    "skillId",
    "version",
    "passId",
    "requestId",
    "profile",
    "tabId",
    "capabilityRevision"
  ],
  "additionalProperties": false
}

Returns

service-envelope; nested/native/action values remain extensible

Output schema
{
  "type": "object",
  "properties": {
    "skill": {
      "type": "object",
      "properties": {
        "catalogueId": {
          "type": "string"
        },
        "skillId": {
          "type": "string"
        },
        "version": {
          "type": "string"
        },
        "sourceHash": {
          "type": "string"
        },
        "bundleHash": {
          "type": "string"
        }
      },
      "required": [
        "catalogueId",
        "skillId",
        "version",
        "sourceHash",
        "bundleHash"
      ],
      "additionalProperties": {}
    },
    "result": {
      "type": "object",
      "properties": {
        "result": {
          "type": "object",
          "properties": {
            "value": {}
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "result"
      ],
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "status": {}
  },
  "additionalProperties": {},
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "skill": {
          "type": "object",
          "properties": {
            "catalogueId": {
              "type": "string"
            },
            "skillId": {
              "type": "string"
            },
            "version": {
              "type": "string"
            },
            "sourceHash": {
              "type": "string"
            },
            "bundleHash": {
              "type": "string"
            }
          },
          "required": [
            "catalogueId",
            "skillId",
            "version",
            "sourceHash",
            "bundleHash"
          ],
          "additionalProperties": {}
        },
        "result": {
          "type": "object",
          "properties": {
            "result": {
              "type": "object",
              "properties": {
                "value": {}
              },
              "additionalProperties": {}
            }
          },
          "required": [
            "result"
          ],
          "additionalProperties": {}
        }
      },
      "required": [
        "skill",
        "result"
      ],
      "additionalProperties": {},
      "not": {
        "required": [
          "error"
        ]
      }
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string"
        },
        "status": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "skill": false,
        "result": false
      },
      "required": [
        "error",
        "status"
      ],
      "additionalProperties": {}
    }
  ]
}

REST equivalents

Published REST routes
[
  {
    "method": "POST",
    "path": "/v1/skills/run"
  }
]