Skills Overview

A skill is a reusable playbook or set of instructions the AI can draw on. Write routine know-how in Markdown — “How to create an invoice,” “Report formatting,” “Translation tone guide” — and the AI will reference it at the right moments. Workspace-shared skills are managed on the “Skills” page in the “Configure” section of the sidebar. The page opens as a card grid — switch between “Card view” and “List view” with the toggle in the header; the view you pick is remembered on that device. Click a card to open the skill’s details. Each card also shows how many times the skill has been invoked (for example “12 invocations”). The ”…” menu offers Edit, Download, “Use in chat” — which opens a new chat with the skill already picked in the composer — “Share with organization,” and Delete, and carries the same items wherever you open it — on a card in the grid, or on the detail header in list view.

​

The detail drawer

In card view — and in list view on a narrow window — a skill’s details open in a drawer from the right.

• “Expand” in the drawer header widens it to nearly the full window, and “Collapse” brings it back. The choice is remembered on that device, carries over to the next skill you open, and the editor inherits it too
• Drag the handle on the drawer’s left edge to set the width yourself, between 420 px and 92% of the window. The arrow keys move it 16 px at a time (four times that with Shift), Home and End go to either end, and a double-click restores the default width
• A width you drag lasts only while that drawer is open — it is not saved. The mobile bottom sheet has no handle

​

Anatomy of a skill

A skill follows the SKILL.md format: metadata (frontmatter) plus a body.

​

Where skills are saved (scope)

You can promote (agent-specific → shared) or demote (shared → agent-specific) a skill later. To tweak a shared skill for one agent, use “Copy and edit for this agent only” (fork). Attaching a workspace-shared skill to an agent works from the Skills section of the agent’s configuration panel — or straight from a chat with the agent (Create Skills from Chat).

​

Four ways to create a skill

​

Limits

A single agent can have at most 20 skills attached, and the workspace catalog is capped at the same number. You do not have to count them yourself:

• The agent’s “Add skills” picker shows the headroom as “N / 20 left”
• The Skills page adds an “n / 20” counter beside the page title once two or fewer slots are left
• An in-chat skill suggestion that would go over the limit says so and names the number

If you hit a limit, consider consolidating or pruning existing skills.

​

Version history

A workspace skill’s detail view has two tabs: “Details” — description, source, how many agents use it, an “Invocations” count, and the body — and “History.” The Invocations figure counts how many AI turns have loaded this skill since counting began (several reads within one turn count once). The body preview keeps the line breaks you wrote — a lone newline renders as a line break rather than collapsing into a space (the same in the editor’s Preview tab and an agent’s Instructions preview).

• The history lists past versions with what produced each one: Created, Edited, Updated from chat, Updated by AI, Restored, or Initial version. “Load earlier versions” pulls in more
• Open a version to read its frontmatter (name, description, allowed tools) and body exactly as they were then
• “Restore this version” brings those contents back as a new latest version — your current content is not discarded, it stays in the history. Agents in the workspace that have the skill attached move to the new latest version automatically

​

Provenance

The skill list shows each skill’s provenance (Manual / AI generated / Imported), and you can filter by it.