skill_save

Create a draft or reviewed skill, or revise an owned skill using its ID and current revision. Keep secrets and private source facts out of shared skills. Channel audience is the default; guild explicitly shares a ready skill with the guild. Updates preserve the existing audience.

User guide / All capabilities

Contract

Effect: write. Evidence role: discovery_only.

Save skill.

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "revision": {
      "type": "number"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "instructions": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "draft",
        "ready"
      ]
    },
    "scope": {
      "type": "string",
      "enum": [
        "channel",
        "guild"
      ]
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "examples": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "name",
    "description",
    "instructions",
    "capabilities",
    "examples",
    "status"
  ]
}

Execution requirements

The ordinary admission and tool execution checks apply.

Expected postconditions

Inspect the returned status, summary and data; do not infer success from a tool call alone.