> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Skill

> Build and publish a Skill bundle from SKILL.md and optional text files.

# Create a Skill

Some Gateway deployments expose the Skill extension tool whose source name is
`create_skill`. Use the exact namespaced name returned by authenticated
`tools/list`.

<Warning>
  This compatibility tool is not declared by the current Agent Gateway `main`
  branch. Call it only when it appears in your connected deployment's
  `tools/list` result. Prefer the CLI or HTTP API for a portable publishing
  workflow.
</Warning>

* Inputs: required `name`, `workspace_id`, and `skill_md`; optional `files`, an
  object mapping relative paths to text content; plus any common fields added
  by Gateway, such as `rationale` or `session_id`.
* Returns: the created Skill view, including its `skill_...` ID.
* Effect: writes a Skill and its bundled files in the selected workspace.

Gateway builds a ZIP bundle, validates it, and stores each file. This tool
accepts text files only. Use the HTTP upload flow when the package contains
binary files.