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

sym_skills_manage

Create/update catalogues, publish immutable versions, rename/archive skills, grant/revoke account access, and link/unlink catalogues to authorized Browser Passes. Requires repository role and explicit task authorization. Does not execute code or grant browser access. Read sym_docs for exact action schemas.

API 2.3.3 · Published service contract ↗

Permissions

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

Arguments

FieldTypeRequiredDescription
actionstring✓Values: ["catalogue.create","catalogue.update","grant.set","grant.remove","link.set","link.remove","version.publish","skill.update"]
argsobject✓
Complete input schema
{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "catalogue.create",
        "catalogue.update",
        "grant.set",
        "grant.remove",
        "link.set",
        "link.remove",
        "version.publish",
        "skill.update"
      ]
    },
    "args": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "catalogueId": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            },
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "description": {
              "default": "",
              "type": "string",
              "maxLength": 2000
            }
          },
          "required": [
            "catalogueId",
            "name"
          ],
          "additionalProperties": false,
          "title": "catalogue.create"
        },
        {
          "type": "object",
          "properties": {
            "catalogueId": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            },
            "expectedRevision": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "description": {
              "type": "string",
              "maxLength": 2000
            },
            "archived": {
              "type": "boolean"
            }
          },
          "required": [
            "catalogueId",
            "expectedRevision"
          ],
          "additionalProperties": false,
          "title": "catalogue.update"
        },
        {
          "type": "object",
          "properties": {
            "catalogueId": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            },
            "expectedRevision": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "accountUid": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            },
            "role": {
              "type": "string",
              "enum": [
                "reader",
                "editor"
              ]
            }
          },
          "required": [
            "catalogueId",
            "expectedRevision",
            "accountUid",
            "role"
          ],
          "additionalProperties": false,
          "title": "grant.set"
        },
        {
          "type": "object",
          "properties": {
            "catalogueId": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            },
            "expectedRevision": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "accountUid": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            }
          },
          "required": [
            "catalogueId",
            "expectedRevision",
            "accountUid"
          ],
          "additionalProperties": false,
          "title": "grant.remove"
        },
        {
          "type": "object",
          "properties": {
            "catalogueId": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            },
            "passId": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            },
            "expectedRevision": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "catalogueId",
            "passId",
            "expectedRevision"
          ],
          "additionalProperties": false,
          "title": "link.set"
        },
        {
          "type": "object",
          "properties": {
            "catalogueId": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            },
            "passId": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            },
            "expectedRevision": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "catalogueId",
            "passId",
            "expectedRevision"
          ],
          "additionalProperties": false,
          "title": "link.remove"
        },
        {
          "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}$"
            },
            "expectedRevision": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "SKILL metadata revision, not catalogueRevision. New skill: 0; existing skill: revision from list or previous response.skill.revision."
            },
            "manifest": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "pattern": "^[A-Za-z0-9_.-]{1,128}$",
                  "description": "Must exactly equal the outer skillId."
                },
                "version": {
                  "type": "string",
                  "pattern": "^[A-Za-z0-9_.-]{1,128}$",
                  "description": "Must exactly equal the outer version; published versions are immutable."
                },
                "description": {
                  "type": "string",
                  "maxLength": 2000
                },
                "origins": {
                  "minItems": 1,
                  "maxItems": 20,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "format": "uri",
                    "description": "Exact HTTP(S) origin, e.g. https://example.com; no path."
                  }
                },
                "effect": {
                  "type": "string",
                  "enum": [
                    "read",
                    "write"
                  ],
                  "description": "Declared behavior; not a JavaScript sandbox."
                },
                "inputSchema": {
                  "anyOf": [
                    {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {}
                    },
                    {
                      "type": "boolean"
                    }
                  ],
                  "description": "JSON Schema draft-07 for the skill input or returned output."
                },
                "outputSchema": {
                  "anyOf": [
                    {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {}
                    },
                    {
                      "type": "boolean"
                    }
                  ],
                  "description": "JSON Schema draft-07 for the skill input or returned output."
                },
                "codeSha256": {
                  "description": "Optional exact UTF-8 source hash. Omit it normally: the server computes sourceHash. If supplied, it must match.",
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                }
              },
              "required": [
                "id",
                "version",
                "description",
                "origins",
                "effect",
                "inputSchema",
                "outputSchema"
              ],
              "additionalProperties": {}
            },
            "source": {
              "type": "string",
              "maxLength": 100000
            },
            "provenance": {
              "type": "object",
              "properties": {
                "workspace": {
                  "type": "string",
                  "pattern": "^[A-Za-z0-9_.-]{1,128}$"
                },
                "profile": {
                  "type": "string",
                  "pattern": "^[A-Za-z0-9_.-]{1,128}$"
                },
                "originalHash": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                }
              },
              "required": [
                "workspace",
                "profile"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "catalogueId",
            "skillId",
            "version",
            "expectedRevision",
            "manifest",
            "source"
          ],
          "additionalProperties": false,
          "title": "version.publish"
        },
        {
          "type": "object",
          "properties": {
            "catalogueId": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            },
            "skillId": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.-]{1,128}$"
            },
            "expectedRevision": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Current SKILL metadata revision, not catalogueRevision."
            },
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "description": {
              "type": "string",
              "maxLength": 2000
            },
            "archived": {
              "type": "boolean"
            }
          },
          "required": [
            "catalogueId",
            "skillId",
            "expectedRevision"
          ],
          "additionalProperties": false,
          "title": "skill.update"
        }
      ]
    }
  },
  "required": [
    "action",
    "args"
  ],
  "additionalProperties": false
}

Returns

open-object; see responseContract.payloads and live/version-specific contract

Output schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": {}
}

REST equivalents

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