Skip to main content
Use extension__skill__create to create one or more Skills in one call. For a small text bundle, send its files inline with files. For any other bundle, upload the ZIP and create a File artifact for it first.
  • Required input: skills, an array with at most 100 items.
  • Required per item: name, workspace_id, and exactly one of files or bundle_file_id.
  • Optional per item: display_name, description, project_id, source_type, and source_id.
  • Optional common inputs: session_id and Gateway’s rationale.
  • Returns: one status slot per input Skill.
  • Effect: write; not idempotent.
files is a map of relative paths to UTF-8 text, such as {"SKILL.md": "...", "references/help.md": "..."}: the server builds the ZIP and runs the same workspace permissions, bundle validation, security scan, and publication gate as the ZIP flow. Across the batch: at most 256 KiB of UTF-8 text and 128 files, with SKILL.md at the root. Paths are relative slash-separated names of at most 1,024 bytes and eight components; traversal, empty components, backslashes, colons, control characters, and a path that is also the folder of another path are refused. Inline files become regular text files with mode 0644, so a binary or an executable file goes through the ZIP flow. Do not include secrets: tool arguments may be retained in audit records. bundle_file_id is the file_... handle of an uploaded .zip. Do not base64-encode a bundle into the tool call. Reserve an upload with registry__request_file_upload, upload the ZIP, create the File artifact, and pass its handle here. Retry only failed items. A Skill’s identity in a workspace is workspace_id, source_type, and source_id; source_type is one of local, git, atlan, or external and defaults to local, and source_id defaults to the Skill’s name. To append a version to an existing Skill, read it first and reuse all three values — a matching name alone is insufficient and can return 409. Appending a version also requires update permission on the workspace. For a small text bundle, appending a version means sending its complete files map again.