> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackmountain.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to Skills

> Reusable instructions the assistant loads when they fit the task

> [!NOTE]
>
> Requires the **Skills** feature to be enabled for your organization. Ask your administrator if you can't see it.

A skill is a set of written instructions for a task you repeat, such as "review a tender for risks and deadlines" or "write in our brand voice". You write it once, attach it where you need it, and the assistant follows it whenever the task comes up. That saves you from pasting the same long prompt into every chat.

## How skills work

Each skill has four parts:

| Part | What it is for |
| - | - |
| **Title** | The label you see in lists and pickers. |
| **Name** | A short machine name the assistant sees, such as `tender-review`. |
| **Description** | Tells the assistant *when* to use the skill. |
| **Instructions** | The body of the skill: how to do the task, step by step. |

When you attach skills to a chat, the assistant only sees each skill's name and description at first. It loads the full instructions only when your request matches a skill. This keeps every message fast and cheap, even with many skills attached. When the assistant loads a skill, the chat shows **Used skill:** followed by the skill's title. Click it to see the instructions it loaded.

Because the description decides when a skill is used, write it as a trigger: "Use when reviewing a tender document for risks and deadlines."

## Where skills live

You write and manage skills in the **Skills** section of the [Editor](https://docs.blackmountain.io/editor/introduction.md) sidebar. Each skill's instructions are an editor document, so you get the same formatting, autosave and [version history](https://docs.blackmountain.io/editor/revisions.md) as any other document.

> [!NOTE]
>
> Creating and editing skills also requires the **Editor** feature. If your organization has Skills but not the Editor, you can still use skills your teammates share with you.

## Where you can use skills

* In a single chat, from the composer.
* On an assistant, so every chat with it can use the skills.
* On a project, so every chat in the project can use them.
* On a scheduled task.
* In the editor's **Ask AI** rewrite, one skill at a time.

See [Attaching skills](https://docs.blackmountain.io/editor/skills/attaching-skills.md) for each of these.

## Related

> [card] [Creating skills](https://docs.blackmountain.io/editor/skills/creating-skills.md)
>
> Write a skill or import a SKILL.md file.

> [card] [Skill groups](https://docs.blackmountain.io/editor/skills/skill-groups.md)
>
> Bundle skills so you can attach them together.

> [card] [Attaching skills](https://docs.blackmountain.io/editor/skills/attaching-skills.md)
>
> Use skills in chats, assistants, projects and tasks.

> [card] [Sharing skills](https://docs.blackmountain.io/editor/skills/sharing-skills.md)
>
> Give a team read-only use of your skills.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.