Skip to content

Teach the agent a task

A skill is a task you teach the agent once, so you do not have to explain it again each time. A skill is a folder with a file called SKILL.md inside it. That file describes how to do the task.

Your skills are in Settings → Extensions, under Skills. They are grouped by where they came from: your own, the ones that are Built in, and the ones From your organization.

Way to add oneUse it when
Create skill in chatYou want help writing it. The agent asks about the task and writes the skill with you.
Write a skillYou prefer to write SKILL.md yourself.
Import local skillYou already have a folder with a SKILL.md in it.

When the agent proposes a skill in a chat, read it before you save it. If it contains something that looks like a password or a key, the app warns you.

The agent picks a skill by itself when your task fits it. You can also name it: type / at the start of the task field and choose the skill.

A skill you add is saved in one place on your computer, and every project and chat on this computer can use it.

Skills inside a project’s own folder are not used. If a project has some, its page tells you, and you can add them on the Skills page instead.

You can share a skill you wrote. Choose Share with your team, then whether to share it with your whole organisation or with named colleagues. Your organisation can turn sharing off.

If a skill your organisation shares has the same name as one of yours, your organisation’s skill is the one used.