| 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. |