name | String! | Yes | Becomes the skill directory name and the skill id. For example “daily-changelog-flow”, not “daily—changelog”. A skill cannot be renamed. There is no display_name field; put the human-readable label in description. |
description | String! | Yes | |
allowedTools | [String!] | No | Tool IDs the skill may call; default none. |
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. |
