skills_update
Publish a new immutable live version.
Effect: This call saves data or changes configuration. Review the behavior below before using it.
Inputs
Choose one input mode. Text mode requires name, description, and instructions. File mode requires files. Do not combine the modes.
skill_id
string
Required
Skill ID returned by skills_list.
name
string
Required in text mode
Resource name.
description
string
Required in text mode
Description of the resource or requested change.
instructions
string
Required in text mode
Full Markdown body of the skill instructions, required in text mode.
actions
array of strings
Optional
Complete array of provider_id.action_id references. On skill update, omission or null clears the existing references.
files
array of file objects
Required in file mode
Array of {path, content_base64}. Include a root SKILL.md with name and description frontmatter. Paths must be relative, with no .. segments.
Each file contains path (relative path) and content_base64 (standard base64). File mode requires SKILL.md at the root. Its YAML frontmatter must include name and description.
Example
These are MCP tool arguments, not an HTTP request body. Replace bracketed IDs with values returned from your account.
This example intentionally leaves no action references. To preserve existing actions, replace actions with the complete array from skills_get.
{
"skill_id": "<skill-id>",
"name": "Evidence-based answers",
"description": "Answer questions using supplied evidence.",
"instructions": "Use the supplied sources. Cite each material claim. State what information is missing.",
"actions": []
}Result
Abbreviated result example; unshown fields are omitted for clarity.
Behavior
Text mode requires the full name, description and instructions, and preserves existing supporting files.
Resend the complete actions list to preserve it; omitted/null actions clears references.
File mode replaces the complete file set.
Every successful call appends a version; agents resolve the latest version immediately.
Builtins cannot be updated; writes require the creator or an organization admin.
Troubleshooting
Built-in skills cannot be updated. You must be the creator or an organization admin. Read the latest version and resend all values you intend to retain; a repeated successful call creates another version.
Related resources
Was this helpful?

