Creates a new version of a skill. If the skill does not exist, it will be created. Creates a new version of a skill from uploaded files via multipart form data.

The name of the skill. If the skill does not exist, it will be created.

A feature flag opt-in required when using preview operations or modifying persisted preview resources.

The API version to use for this operation.

The multipart request content.

Inline content for defining a simple skill without uploading files. Follows the agentskills.io SKILL.md specification.

A human-readable description of what the skill does and when to use it.

The skill instructions in markdown format. This is the body content of the SKILL.md file.

License name or reference to a bundled license file.

Environment requirements or compatibility notes for the skill.

Arbitrary key-value metadata for additional properties.

List of pre-approved tools the skill may use. Experimental.

Whether to set this version as the default.

Skill files to upload. Upload a single zip file or multiple individual files with relative paths.

Whether to set this version as the default. Defaults to false.

The unique identifier of the skill version.

The identifier of the parent skill.

A skill name following the agentskills.io spec: lowercase letters, numbers, and hyphens only. Must not start or end with a hyphen or contain consecutive hyphens.

The version identifier. Skill versions are immutable.

A human-readable description of the skill version.

The public explanation for this block.

The public continuation instruction.

The public explanation for this block.

The public continuation instruction.