Update skill

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

Requires project.agents.write.

Arguments

ArgumentTypeRequiredDescription
projectReferenceString!Yes
idString!YesThe id of the definition, from its list.
inputUpdateSkillInput!Yes

Input fields

input

UpdateSkillInput

FieldTypeRequiredDescription
nameStringNoMust equal the id argument when sent: a skill cannot be renamed.
descriptionString!Yes
allowedTools[String!]NoReplaces the list when sent; omit it to keep the current list.
instructionsStringNoFull 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.
sourceTargetKindWriteTargetKindNoThe source to write; default project.
targetBranchIdIDNoRequired with the kind preview_branch.

Response

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

FieldTypeDescription
idID!
nameString!
descriptionString!
sourcePathString!
editModeSourceEditMode!
allowedTools[String!]!
instructionsString!The Markdown body of SKILL.md, excluding frontmatter.
sectionsStringMap!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

graphql
mutation UpdateSkill($projectReference: String!, $id: String!, $input: UpdateSkillInput!) {
  updateSkill(projectReference: $projectReference, id: $id, input: $input) {
    id
    name
    allowedTools
    description
    editMode
  }
}
json
{
  "projectReference": "00000000-0000-4000-8000-000000000001",
  "id": "example",
  "input": {
    "description": "example"
  }
}