> ## Documentation Index
> Fetch the complete documentation index at: https://developers.myhero.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Update skill

> Change a workspace skill: rename it, rewrite its description or instructions, turn it on or off, or change the projects it applies to. Pass only what…

`update_skill`

Change a workspace skill: rename it, rewrite its description or instructions, turn it on or off, or change the projects it applies to. Pass only what changes. `instructions` replaces the whole body, so call get\_skill first and send the full revised text.

## Parameters

**skillId** `string` *required*

**name** `string`

Short Title Case name for what the skill covers, e.g. "Contract Review".

**description** `string`

When the AI should use the skill. The AI decides from this alone whether to load it, so name the requests it covers. For a rule that must always hold ("never do X"), say it applies to every request.

**instructions** `string`

The skill's body in plain Markdown (headings, lists, bold, tables, code), written as direct instructions to the AI. Not HERO's extended syntax: no @clause, placeholders or other HERO blocks.

**enabled** `boolean`

Whether the AI uses the skill.

**projectIds** `array\<string\>`

Limit the skill to these projects; an empty list applies it across the workspace. When the user says a skill is for somewhere by name, check whether that is a project (limit to it) or the workspace itself.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.