Skip to main content

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.
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.
  • 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.