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

# Creating Skills

> Write a skill in the editor or import a SKILL.md file

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

You create skills in the **Skills** section of the [Editor](https://docs.blackmountain.io/editor/introduction.md) sidebar. A new skill opens as a document where you write the instructions. You can also import an existing `SKILL.md` file.

![A skill in the Editor](https://mintcdn.com/blackmountaingmbh/XFag3CE4nO-WN3UD/images/screens/en/skills/skill.png?fit=max\&auto=format\&n=XFag3CE4nO-WN3UD\&q=85\&s=269b0e00ffc1c6f5c4b75d6e8c0fbac0)

## Create a skill

1. Open **Editor** in the main navigation.
2. In the sidebar, find the **Skills** section and click **New skill**.
3. Enter a **Title**, for example "Tender review".
4. Enter a **Description**. The assistant reads this to decide when to use the skill, so describe the situation: "Use when reviewing a tender document for risks and deadlines."
5. Under **Sharing**, choose **Private** or **Team**. See [Sharing skills](https://docs.blackmountain.io/editor/skills/sharing-skills.md).
6. Click **Create**. The skill's document opens.
7. Write the instructions in the document. Describe when and how to perform the task, step by step.

The document saves automatically as you type.

## The skill panel

Above the instructions, the skill panel holds the settings the assistant sees:

* **Name**: the machine name the assistant uses to load the skill. It is filled in from the title. Use lowercase letters, numbers and single dashes, for example `brand-voice`, up to 64 characters. Each of your skills needs a different name.
* **Description**: up to 1,024 characters.
* **Sharing** and **Groups**: these apply as soon as you change them.

Changes to **Name** and **Description** apply only when you click **Save**.

## Write good instructions

* Start with the goal and the expected result.
* List the steps in order. Number them if the order matters.
* Include checklists, templates, tone rules or examples the assistant should follow.
* Keep one task per skill. Several focused skills work better than one long one.

Instructions can be up to 200,000 characters.

## Import a SKILL.md file

If you already have a skill file with YAML frontmatter (the format used by Anthropic-style skills), you can import it.

1. In the **Skills** section, click **Import SKILL.md**.
2. Choose a `.md` file.

48° reads the file like this:

* `name` in the frontmatter becomes the skill's name. If you already have a skill with that name, a suffix is added.
* `description` becomes the description. It is required and can be up to 1,024 characters.
* The markdown body becomes the instructions. Its first `#` heading becomes the title.

Only the markdown is imported. Scripts or other files that the skill refers to are not.

## Edit, rename or delete a skill

Click a skill in the **Skills** section to open its instructions. Open the **⋯** menu on the skill to:

* **Rename**: changes the title shown in lists. The name the assistant sees stays the same; change it in the skill panel.
* **Description and sharing**: edit the description and who can use the skill.
* **Groups**: add the skill to or remove it from [skill groups](https://docs.blackmountain.io/editor/skills/skill-groups.md).
* **Delete**: deletes the skill and its instructions permanently.

Only the owner can edit a skill.

## Related

> [card] [Attaching skills](https://docs.blackmountain.io/editor/skills/attaching-skills.md)
>
> Put your new skill to use.

> [card] [Revisions and restore](https://docs.blackmountain.io/editor/revisions.md)
>
> Go back to an earlier version of the instructions.


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