Skills Overview

How skills — reusable playbooks and instructions for the AI — work

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. Click a card to open the skill’s details.

Anatomy of a skill

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

Field	Description
Name	The skill’s name (e.g., PDF Extract)
Description	What the skill does and when to use it. This is how the AI decides which skill to pick
Allowed tools (optional)	Restricts which tools this skill may use. Leave blank for no restriction
Body	The procedures and instructions, written in Markdown

Where skills are saved (scope)

Location	Description
Workspace shared	Attachable by every agent. Shown on the Skills page
Agent-specific	Used by one agent only. Managed in the Skills section of the agent’s configuration panel

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

Write it in the editor

Write SKILL.md directly from “New skill” on the Skills page

Have the AI generate it

Enter a name and description, then “Auto-generate body”

Import a .md file

Import an existing SKILL.md by drag & drop or paste

Accept a suggestion from chat

The AI suggests turning procedures established in conversation into skills

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.

Provenance

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