skill_delete

Retire a skill by ID and current revision. Historical revisions remain available in durable storage but retired skills cannot be loaded or discovered.

User guide / All capabilities

Contract

Effect: destructive. Evidence role: discovery_only.

Retire skill.

Parameters

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

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "revision": {
      "type": "number"
    }
  },
  "required": [
    "id",
    "revision"
  ]
}

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.