Detach a skill from an agent
detach_skillDetach a skill from an agent. The skill stays in the organization for other agents, including an organization copy installed from the catalog. Give a built-in's name to detach Valet's default of it. The agent is rebuilt so it stops carrying the skill. Detaching a skill that is not attached changes nothing. Returns the agent and the skill as passed, and not_attached when it was not attached. Requires connecting a Valet account.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"skill": "<skill>"
},
"name": "detach_skill"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The agent's name, as list_services shows it: the agent to detach the skill from. | |
| skill | Yes | The skill's name, or a ref such as catalog:<name> or org:<name>. | |
| org_name | No | The Valet organization the agent belongs to. Omit to use the organization the account joined first. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| org | Yes | Name of the Valet organization the call acted in. | |
| kind | Yes | Kind of the service the skill attaches to. Always agent: skills attach to agents only. | |
| name | Yes | Name of the agent. | |
| skill | Yes | The skill as you passed it. | |
| not_attached | No | True when the skill was not attached and nothing changed. Absent when it was detached. |