Skip to content
LogoLogo

Skills

Why skills exist

Without skills, the same rules get copy-pasted into five agents. When the policy changes, four of them silently go stale.

With skills, you edit one page and every agent that uses it is updated.

Good candidates for a skillKeep in instructions instead
Brand voice and toneAnything unique to this one agent
Escalation policyThe agent's specific step-by-step job
Report or email templatesOne-off phrasing tweaks
Compliance wording
How to format a citation

A skill has three parts

PartRequiredNotes
NameYesShort and descriptive, such as "Acme brand voice".
DescriptionYesOne line, so teammates know when to attach it.
ContentYesThe instructions themselves, written in Markdown.

Studio records the size of each skill so you can see which ones are getting heavy.

Create a skill

  1. Go to Skills in the sidebar.
  2. Click Create skill.
  3. Fill in the name, description and content.
  4. Save.

Skills list page and the "New skill" editor with name, description and Markdown content

Example: "Acme brand voice"

# Acme brand voice
 
- Write in plain English. Short sentences. No jargon.
- Address the reader as "you". Never "the user".
- Never use: leverage, synergy, cutting-edge, revolutionary.
- Numbers under ten are written as words, ten and above as digits.
- Sign off as "The Acme team", never with an individual name.

Attach a skill to an agent

  1. Open the agent in the Agent Builder.
  2. Scroll to Skills.
  3. Click Add skill and pick from the list.

To attach a skill you need Editor on the agent and at least Viewer on the skill. If you cannot see a skill in the picker, it has not been shared with you.

Detaching removes it from that agent only. The skill itself is untouched.

Builder Skills section with two skills attached, and the attach dialog open

Sharing skills

Skills use the same three-level sharing as agents and knowledge bases:

LevelCan
ViewerRead the skill and attach it to agents they can edit.
EditorChange its name, description and content.
AdminDelete it and share it with others.

You can share with a person, a group, or the whole organization.

Creating a skill without leaving the builder

The builder has a Create skill shortcut in the Skills section, so you can pull a block of instructions out into a skill the moment you notice you are repeating yourself.