Skip to content
Basics

Agent Skills

Agent Skills are packaged capabilities that give Agents pre-built expertise for specific tasks. By uploading skill packages to the platform and adding them to servers, Agents come pre-populated with the ability to perform complex operations without needing custom prompts or manual configuration each time.

Skills list
Skills list

Scope levels

Skills can be defined at three levels:

  • Organization — Available to all servers in the Organization. Organization-level skills start disabled by default and must be explicitly enabled per server.
  • User — Personal skills that apply to your servers. User-level skills start enabled by default.
  • Workspace — Specific to servers within a single workspace. Workspace-level skills start enabled by default.

Managing skills

Browsing skills

Navigate to the Agent Skills page from the left sidebar to view all available skills. You can filter by scope (Organization, User, or Workspace) to find specific skills.

Adding a skill

To add a new skill:

  1. Click the Add button
  2. Select the scope (Organization, User, or Workspace)
  3. Provide a name and description for the skill
  4. Upload the skill package file (.tar.gz or .zip)
  5. Review the skill's metadata — name, description, version, and trigger configuration
  6. Save the skill

How to edit and remove skills

Click on any skill to edit its name, description, or configuration. You can also delete skills you no longer need.

Server overrides

When working within a server, you may want to enable or disable inherited skills from the Organization or User level without changing the original skill.

From the server details, the Agent Skills section shows all applicable skills and allows you to:

  • Enable Organization-level skills that are disabled by default
  • Disable User-level or Organization-level skills for this specific server
  • Add workspace-specific skills

These overrides only affect the current workspace and do not change the original skill at the Organization or User level.

Skill package structure

A skill is a directory containing, at minimum, a SKILL.md file. The SKILL.md file contains YAML frontmatter (metadata) followed by Markdown instructions the Agent follows when the skill is activated.

Optional directories:

  • scripts/ — Executable code the skill can run
  • references/ — Additional documentation the Agent can read when needed
  • assets/ — Static resources like templates, schemas, and data files

See the full Agent Skills specification for details.

Building your own skills

Want to create a custom skill for your Organization? See the Creating Agent Skills developer guide for the full walkthrough — from writing the SKILL.md file to packaging and publishing.