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

# Attaching Skills

> Use skills in a chat, assistant, project or scheduled task

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

A skill does nothing until you attach it. You can attach skills and [skill groups](https://docs.blackmountain.io/editor/skills/skill-groups.md) to a single chat, or to an assistant, project or scheduled task so they are available every time. The assistant then decides on its own when an attached skill fits your request and loads it.

## In a chat

1. In the composer, click the skills button (**Choose skills**) next to the model picker.
2. Search for and select the skills and groups you want. Groups are listed first.
3. Send your message.

You can also type `/` in the composer followed by a skill or group name. Press **Enter** to add it. The `/name` stays in your message, and deleting it before you send removes the skill again.

Your selection is saved with the chat and stays in place for the following messages.

To pause skills without removing them, open **Add files and more** in the composer and turn off **Skills**. This option appears once you have selected at least one skill.

## On an assistant

1. Open the assistant in **Assistant Studio** and edit it.
2. In the **Skills** field, select skills and groups.
3. Save the assistant.

Every chat with that assistant can use these skills. Who can use the assistant limits which skills you can attach:

* A private assistant can use any skill you can see.
* A team assistant can only use skills and groups shared with that same team.
* Workspace and organization assistants cannot use skills.

## On a project

1. Open the project, click the **⋯** menu (**Project actions**) and choose **Edit**.
2. In the **Skills** field, select skills and groups.
3. Save the project.

Every chat in the project can use these skills.

## On a scheduled task

1. Open **Scheduled Tasks** and edit the task.
2. In the **Skills** field, select skills and groups.
3. Save the task.

The skills are available each time the task runs.

## How attached skills combine

In a chat, the assistant can use the skills you selected in the composer plus those attached to the chat's assistant and project. Skills that come from the assistant or project show in the composer picker as locked, labeled **from assistant** or **from project**. You can't remove them from the chat.

> [!NOTE]
>
> You can select up to 50 skills and 20 groups in one place. The assistant is offered at most 50 skills per message in total.

If a skill is deleted or no longer shared with you, it is skipped silently. The chat still works without it.

## In an Ask AI rewrite

When you rewrite a selection with [Ask AI](https://docs.blackmountain.io/editor/editing-with-ai.md) in the editor, you can pick one skill under **Apply a skill**. Its instructions guide the rewrite.

## Related

> [card] [Assistant configuration](https://docs.blackmountain.io/assistants/configuration.md)
>
> All the settings on an assistant.

> [card] [Projects](https://docs.blackmountain.io/chat/projects.md)
>
> Group chats with shared settings.

> [card] [Scheduled tasks](https://docs.blackmountain.io/scheduled-tasks/introduction.md)
>
> Run prompts on a schedule.

> [card] [Sharing skills](https://docs.blackmountain.io/editor/skills/sharing-skills.md)
>
> Why some skills can't be attached to a team assistant.


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