v1

latestOpenAPI 3.0.32026-07-222111928.0 KB

Skills

Create Skill

Create or update a skill from a JSON body. The server constructs SKILL.md from the provided fields and stores it. If a skill with the same name already exists in the team, it is updated.

post/v2/teams/{teamId}/skills

Path parameters

teamIdstring required

Request body

namestring required

Skill name. 1-64 lowercase alphanumeric chars and hyphens; no leading/trailing or consecutive hyphens.

descriptionstring required

1-1024 chars describing what the skill does and when to invoke it.

contentstring required

Markdown body of SKILL.md without YAML frontmatter. The server prepends the frontmatter from the other fields.

licensestring

Optional: license name or reference to a bundled license file.

compatibilitystring

Optional: 1-500 chars describing environment requirements.

metadataobject

Optional: arbitrary key-value metadata.

allowed-toolsstring

Optional (experimental): space-delimited list of pre-approved tools.

Response

Default Response