> For the complete documentation index, see [llms.txt](https://docs.jetadmin.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jetadmin.io/agents/agent-skills.md).

# Agent Skills

A skill can contain custom instructions, knowledge, or specialized behaviors that agents can use when responding to users.

Skills can be attached to multiple agents and managed centrally.

### Add a Skill

To add a skill:

1. Open your agent settings
2. In the right-side **Skills** section, click **Add Skill**

{% @arcade/embed flowId="fBapfj7IiEbENYYrxIl0" url="<https://app.arcade.software/share/fBapfj7IiEbENYYrxIl0>" %}

{% hint style="info" %}
There are two ways to create a skill:

* Upload a skill file
* Write skill instructions manually
  {% endhint %}

### Upload a Skill

To upload an existing skill:

1. Click **Upload Skill**
2. Select the skill file from your device

The skill will be uploaded and added to the agent.

<figure><img src="/files/sYP2LxpBQntWk4DgbecM" alt=""><figcaption></figcaption></figure>

### Write Skill Instructions

You can also create a skill manually.

Fill in the following fields:

| Field        | Description                                      |
| ------------ | ------------------------------------------------ |
| Skill Name   | Name of the skill                                |
| Description  | Short description of what the skill does         |
| Instructions | Detailed instructions and behavior for the skill |

After completing the fields, click **Create Skill**.

<figure><img src="/files/8vyrPEj89IkgRRuJgoMH" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

## Managing Skills

After creating a skill, you can:

* Add it to multiple agents
* Edit the skill
* Download the skill
* Replace the skill file
* Delete the skill
  {% endhint %}

### Using Skills in Agent Instructions

After attaching a skill to an agent, you should define in the agent instructions:

* When the skill should be used
* How the skill should be used
* Which types of requests should trigger the skill

This helps the agent understand when to apply the connected skill during conversations.

> **Best Practice**
>
> Keep skill instructions focused and specific.\
> Clearly describing when a skill should be used improves agent reliability and response quality.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.jetadmin.io/agents/agent-skills.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.