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

# Skills and templates

> Save instructions and prompts so Minerva Agent handles repeat work the same way each time

Skills and templates both make repeat work with Minerva Agent faster, but they do different jobs.

| | Skill | Template |
| - | - | - |
| What it is | Reusable instructions for how to do a type of work. | A saved prompt that starts a chat. |
| How you use it | Type `/` in a chat and select it, or let the Agent pick it up automatically. | Select its card under the chat box. |
| Where it lives | **Agent → Skills** | **Agent → Templates** |

For work that should run on its own at a set time, use a schedule.

## Create a skill

**1. Open Skills**

Go to [**Agent → Skills**](https://app.minerva.io/agent/skills) and select **New skill**.

**2. Describe it**

Enter a **Title** and a **Description**. The description helps teammates choose the skill and helps the Agent decide when it's relevant.

**3. Write the instructions**

Write the instructions in Markdown: the task, the inputs, the checks to make and the output you want.

**4. Choose who can use it**

Under **Sharing**, choose **Personal** or **Shared**. For a shared skill, choose who can edit it.

**5. Create it**

Create the skill. It is installed for you automatically.

> [!WARNING]
>
> Don't put passwords, keys or customer lists in a skill's instructions.

## Use a skill

* **Run it yourself.** In a chat, type `/`, select the skill, add your request and send. Selecting a skill doesn't run anything until you send the message.
* **Let the Agent use it.** With **Automatic** on, the Agent uses the skill on its own when it fits your request.
* **Pin it.** Select **Pin skill** to keep it handy for you, without changing anything for your teammates.

The Skills page groups skills under **Installed**, **Personal**, your organization's name and **Minerva**.

| Kind | What to know |
| - | - |
| Built-in skills | Included with Minerva: **Report**, **Template** and **Investigate unmatched records**. They appear under **Installed** and **Minerva**, and can't be edited or uninstalled. |
| Minerva skills | Made and maintained by Minerva. Install the ones you want. |
| Personal skills | Yours, in this organization. |
| Shared skills | Visible to everyone in your organization. Each person installs a shared skill for themselves. |

**Uninstall** removes a skill for you only. **Delete skill** removes it for everyone who uses it.

## Create a template

**1. Open Templates**

Go to [**Agent → Templates**](https://app.minerva.io/agent/templates) and select **New template**. To start from one of Minerva's templates, select **Customize** on it to save your own copy.

**2. Write the prompt**

Enter a **Title**, a **Description** and the **Prompt**.

**3. Choose who can use it**

Under **Sharing**, choose **Personal** or **Shared**. For a shared template, choose who can edit it.

**4. Create it**

Select **Create template**.

You can also ask the Agent to save what you're working on as a template.

## Use a template

Templates appear as cards under the chat box. Selecting a card starts a chat with that prompt.

* **Choose which cards you see.** Use **Show in suggestions**. It only affects you, and a hidden template stays in your library.
* **Make your own copy.** Select **Customize** on a Minerva template to save a personal copy. It doesn't change the template for anyone else.

## Share a skill or template

Setting **Sharing** to **Shared** makes the item visible to everyone in your organization. You choose whether only you and your organization's Admins can edit it, or everyone can.

> [!WARNING]
>
> Sharing can't be undone. A shared skill or template can't be changed back to **Personal**.

## Limits and billing

| Field | Maximum length |
| - | - |
| Title | 120 characters |
| Description | 500 characters |
| Skill instructions or template prompt | 20,000 characters |

Creating, sharing and installing skills and templates doesn't use your record export allowance. If a skill or template leads to an activation or export, it's billed like any other.


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