> 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/ai-agents/instructions-tools-skills-files-and-models/agent-skills.md).

# Agent Skills

Skills allow you to extend agent behavior with reusable instructions and capabilities.

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="https://3448227606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LQ08RFAKZvFADEiXKFy%2Fuploads%2Fgdg6Vc93E70qif3qrT9q%2Fimage.png?alt=media&amp;token=87bf994f-9724-42c0-876d-a1f553d722a1" 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="https://3448227606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LQ08RFAKZvFADEiXKFy%2Fuploads%2FBAR5N2AqhsQb4m2o2k4C%2Fimage.png?alt=media&amp;token=0a8c292e-ee0f-42cd-b317-e7353c620b0b" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.jetadmin.io/ai-agents/instructions-tools-skills-files-and-models/agent-skills.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.