Update skill - Veryfront

updateSkill(projectReference: String!, id: String!, input: UpdateSkillInput!): SkillSource!

Requires project.agents.write.

Arguments

Argument	Type	Required	Description
`projectReference`	`String!`	Yes
`id`	`String!`	Yes	The id of the definition, from its list.
`input`	`UpdateSkillInput!`	Yes

Input fields

input

UpdateSkillInput

Field	Type	Required	Description
`name`	`String`	No	Must equal the id argument when sent: a skill cannot be renamed.
`description`	`String!`	Yes
`allowedTools`	`[String!]`	No	Replaces the list when sent; omit it to keep the current list.
`instructions`	`String`	No	Full markdown body of SKILL.md, meaning everything below the frontmatter, written verbatim with any markdown headings. Sending it replaces the whole body. The former sections object is rejected; put the whole skill here.
`sourceTargetKind`	`WriteTargetKind`	No	The source to write; default project.
`targetBranchId`	`ID`	No	Required with the kind preview_branch.

Response

Returns SkillSource!. Open the type for its fields and nested types.

Field	Type	Description
`id`	`ID!`
`name`	`String!`
`description`	`String!`
`sourcePath`	`String!`
`editMode`	`SourceEditMode!`
`allowedTools`	`[String!]!`
`instructions`	`String!`	The Markdown body of SKILL.md, excluding frontmatter.
`sections`	`StringMap!`	Read-only sections derived from the level-two headings of the body; empty when the body cannot be split.

All fields of SkillSource. Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

mutation UpdateSkill($projectReference: String!, $id: String!, $input: UpdateSkillInput!) {
  updateSkill(projectReference: $projectReference, id: $id, input: $input) {
    id
    name
    allowedTools
    description
    editMode
  }
}

{
  "projectReference": "00000000-0000-4000-8000-000000000001",
  "id": "example",
  "input": {
    "description": "example"
  }
}