Skip to content

Skills

A skill is a procedure written down: how to handle one kind of task. Skills belong to the workspace, and any bot can be given any of them.

A skill has three levels, loaded only as far as needed:

  1. Name and description — always visible to the bot, so it can tell when a skill applies.
  2. Content — the full procedure, in Markdown. Loaded when the bot decides the skill is relevant.
  3. References — extra documents attached to the skill (a price list, an API guide). Read only when the procedure points to them.

So a bot can have many skills without paying for them on every message.

  • Name: lowercase letters, numbers and single hyphens, up to 64 characters — for example monthly-close. Names are unique in the workspace.
  • Description: what the skill is for and when to use it, up to 1024 characters. This is what the bot reads to decide, so make it specific.
  • Content: the steps.

The quickest way is to ask a bot: “turn what we just did into a skill”. It writes the skill and attaches it to itself.

A reference is a separate document attached to a skill: a price list, a rate table, an API guide. The bot reads it only when the skill’s content points to it, so long reference data stays out of every message.

  • Add one: ask a bot in chat, “add a reference with the price list to the monthly-close skill”, and it writes it. Over the API, POST /skills/{skillId}/references/ with name, content and an optional description.
  • Point to it: in the skill’s content, use the path references/<name>.md, for example “take prices from references/prices.md”. Without that, the bot never learns it exists.

A skill’s references are listed on its card under Plugins.

Each bot has a skill authoring setting:

Setting The bot can
workspace Create, edit and delete any skill, and attach skills to other bots (default)
own Create skills and edit only the ones it wrote; attach only to itself
off Use its skills, but not create or change any

See Skills in the API reference.