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.
• 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 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 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.