skill_delete

Delete an ad-ops playbook (Skill), guarded by base_revision.

Deletes a Skill. Requires the skill:write scope. Like skill_update, it is guarded by base_revision — fetch the Skill first so a concurrent edit can’t be silently lost.

Input

Field	Type	Required	Description
`skill_name`	`string`	yes	The slug identifying which Skill to delete.
`base_revision`	`number`	yes	The `revision` you last read via `skill_get`. Guards against deleting a race.

Output

Confirmation of deletion. The Skill stops appearing in skill_list and skill_get, and its slug becomes free to reuse for a new Skill.

Example

“Delete the old black-friday-audit skill.”

const skill = skill_get({ skill_name: 'black-friday-audit' }); // revision 2
skill_delete({
  skill_name: 'black-friday-audit',
  base_revision: skill.revision,
});

Errors

Stale revision — the Skill changed since you read it. Re-fetch with skill_get and retry with the latest base_revision.
Not found — no Skill with that slug exists.
401 or 403 — see Errors, which every tool shares. This one needs skill:write.

Reference

Delete an ad-ops playbook (Skill). Pass base_revision (from skill_get) — the delete is rejected if the Skill changed since you read it. The slug becomes free to re-use afterwards.

Input

Argument	Type	Required	Description
`base_revision`	integer	yes	The revision you last read via skill_get. Guards against deleting a concurrently-edited Skill.
`skill_name`	string	yes	The Skill slug identifying which Skill to delete.

Failure codes

A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.

not_found
revision_mismatch
forbidden
invalid_request
internal_error

Scope

The token must hold skill:write. Auth & scopes lists each scope.

Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

Writes. The tool can change data.
Destructive. The tool can make a change that you cannot undo. A client can ask you to confirm before it calls the tool.
Not idempotent. A second call with the same arguments can change more.
Closed world. The tool reads and writes the data of AdCrunch only.