Skills

What a skill is

A skill has a Name, a Description, and Instructions written in markdown. All three are required. The split keeps agent prompts small:

The agent sees each available skill as its name and description, with a hint to load it. Activating a skill means the agent calls skill(action='get', skill_id=...), whose result carries the full instructions. Help text sometimes calls this step "discover_skill"; that is only a label, not a separate tool. Names are limited to 255 characters.

Create and edit skills

Skills live in the Skills tab of the Agents page, next to the Agents, Memory, Fleet, Metrics, and Settings tabs.

1. 1
   Open the editor
   In the Skills tab, select Create Skill.
2. 2
   Fill in the three fields
   Enter a Name, a Description, and the Instructions.
3. 3
   Save
   Select Save. The skill appears in the tree, where you can move it into a folder.

Administrators also see a Make available to everyone (global) checkbox in the editor (see Scopes).

Built-in default skills

Every account starts with a set of built-in skills, marked Default in the tree. They are added to your list automatically and are active in new chats. You can edit them, and Reset to default in the editor restores the original content. A default skill cannot be deleted.

Manage skills from an agent

An agent can manage skills through the skill tool:

list returns 25 results per page by default and accepts a query that filters on name and description. Resetting a default skill and turning Default-active in new chats on or off are done in the app, not through the tool.

Organize skills in folders

Folders can nest inside other folders with no depth limit. Drag and drop skills and folders in the tree. A folder cannot be moved into itself or into one of its own subfolders.

Global skills cannot be moved into a personal or team folder. An administrator can also mark a folder as global; this does not change the skills inside it.

Assign skills to agents

Select skills in the agent editor, or let an agent assign them. The skill(action='assign') action is additive: it adds skills to an agent and skips the ones already assigned. By contrast, passing skill_ids when an agent is created or updated replaces the whole set.

You can assign a skill only if it is visible in your workspace, or if it is a global skill.

Default-active skills in new chats

A skill marked Default-active in new chats (in the skill's menu in the tree) is included automatically in every new general chat for everyone who can see it. You can change this on your own skills; on a global skill only an administrator can.

Each person can also switch a skill on or off just for themselves with the toggle on its row, without changing it for anyone else. Your own choice wins; if you have not made one, the skill's default applies.

Scopes

A non-administrator who opens a global skill sees a read-only editor with a notice explaining why. In a team workspace, a skill can also be restricted for a specific member, in which case it does not appear in that member's skill list.

Publish a skill to the marketplace

Publishing creates a marketplace listing. Every listing needs a title and a landing page (an interface people see before they add the skill). See Marketplace for listings and reviews.

• Publishing from the Skills tab always creates a Public listing, which waits for review.
• An agent publishing with the skill tool can choose the visibility; if it passes none, the listing is Private.
• A publish request sent through the REST API without a visibility is Public.

Adding a published skill copies its name, description, icon, and instructions into your own account. Unpublishing stops new people from adding it; existing copies are kept. The Skills tab shows each skill's publication state (published, Pending Review, or rejected with a reason), with Share and Unshare actions.

Global skills on the Community Edition

When the install is linked, it downloads a signed bundle of the cloud's global skills at startup and then about every 15 minutes. The signature is verified before anything is applied.

1. 1
   Skills arrive as global, read-only skills
   Each bundled skill becomes a global skill and keeps the cloud's default-active setting, so it joins new chats the same way. Anyone can switch it off for themselves.
2. 2
   The cloud owns their content
   Bundled skills cannot be edited or deleted locally, even by an administrator.
3. 3
   Updates are safe
   A new bundle updates skills in place. A skill removed from the bundle is deactivated, not deleted. An empty bundle is refused, and a bundle you already have changes nothing.

Troubleshooting

Related pages