# Skills

A skill is written know-how a bot follows for a specific task, such as how you want expenses filed
or how to publish a blog post.

## Use a skill

Bots pick up the right skill on their own when a task matches it. To use one explicitly, type **/**
at the start of a message and choose it.

## Built-in skills

Every bot comes with these, marked **Built-in** in your skills:

- **Opisense**: answers questions about using and setting up Opisense, from these docs.
- **Documents**: makes and edits Word, PDF, Excel and PowerPoint files, and checks each one opens and
  looks right before sending it. It needs the bot's [computer](/docs/computer/).
- **Interrogate**: a skeptical review of a code change, pull request or plan. It reports problems and
  never changes anything.

## Your skills

Open the account menu (your avatar at the bottom of the sidebar), choose **Workspace tools**, then
**Skills**. On mobile, choose **Skills** in the account screen.

- **Discover** finds skills to add.
- **Library** lists **Your skills**, the built-in ones, and **Plugins** whose skills you've added.

Skills you add are available to all your bots.

## Write a skill

Choose **Add skill**, then:

- **With a bot**: choose a bot to prepare a message in its chat. Send it to work out the steps
  together; the bot saves the skill when you agree on it in the chat.
- **Write manually**: edit the name, description and steps in a Markdown editor.

## Find community skills

In **Discover**, **Skill packs** lists ready-made sets of skills. Open one and choose **Add**.

To search more widely, type at least two letters and choose **Search skills.sh** for community
results. Open a result to read it and check its **Source**, then choose **Add skill**. Only
`SKILL.md` is imported; scripts and other files are not. The copy you save is yours to edit and
doesn't follow later changes to the original.

You can also add skills from a GitHub repository: choose **Add skill** → **From GitHub**, paste the
**Plugin GitHub URL**, then choose **Preview** and **Add**.

> [!NOTE]
> Skills added from GitHub or a plugin are instructions only. Any scripts they include are not run.

Bots from the [Marketplace](/docs/marketplace/) can bring their own skills, which are added here.

## Bots save skills too

After a multi-step task, ask the bot to "save that as a skill". It writes the skill so it, and your
other bots, can repeat the task next time. A skill a bot saves stays in the [space](/docs/spaces/) it
was made in.

## Teach a task by showing it

Some tasks are easier to show than describe.

1. Open the bot's settings, and on the **Activity** tab choose **Open** on the computer preview.
2. Choose **Teach a task** and describe the result you will demonstrate, such as "Export this week's
   list from the CRM and drop it in the shared folder".
3. Choose **Start recording** and do the task on the bot's screen. The bot watches but does not act.
   Type passwords with **Protected input** so they are not recorded.
4. Choose **Stop teaching**.

The bot posts a **Draft skill** card with the steps it learned, when to use them, what to check, and
when to ask you first. Edit anything that's off, then choose **Save**. **Test** runs it once, and
**Add to routine** puts it on a schedule.

Teach a task is available on the web and desktop apps, not on mobile.
