# Creating and using custom skills

A custom skill describes a specific action to perform or rule to follow in a specific context. Custom skills are tied to a specific workspace.

For example, whenever you generate date to a REST API, you want the Data Agent to use a specific type of credential and a specific endpoint.

When the Data Agent detects that a configured skill applies in the current context, it automatically uses the skill. You can also load the skill directly.

## Displaying the list of available skills

You manage custom skills from the **Skills** page on the **Agent Instructions** panel.

<figure><img src="/files/tXpwQvYuF00dsjmZOKDI" alt=""><figcaption><p>Skills page on the Agent Instructions panel</p></figcaption></figure>

To display the **Skills** page, either:

* In the Data Agent heading, click the agent instructions icon, then click **Skills**.

<figure><img src="/files/I5PWCH2fb0sEMu4df5J6" alt=""><figcaption><p>Agent instructions icon in the Data Agent heading</p></figcaption></figure>

* In the Data Agent chat prompt, click **Skills**, then click **Manage Skills**. The **Skills** dropdown also displays the available skills.

<figure><img src="/files/wLn928N2meHXrEvCYNjD" alt=""><figcaption><p>Skills dropdown list in the Data Agent chat prompt</p></figcaption></figure>

## Creating a custom skill

To create a custom skill:

1. Either:
   1. In the **Skills** dropdown, click **Add Skill**.
   2. On the **Skills** page, click **New Skill**.

<figure><img src="/files/f8WvzqnDa1y5eevZXld3" alt=""><figcaption><p>Fields to configure a new custom skill</p></figcaption></figure>

2. In the **Name** field, provide a name for the skill.
3. In the **Description** field, provide a description of the context when the Data Agent should load the skill.
4. In the **Instructions** field, provide the specific instructions for the Data Agent to follow when the skill is loaded.
5. Click **Create Skill**.

## Editing a custom skill

You edit a custom skill from the **Skills** page.

1. On the **Skills** page, click the skill to edit.

<figure><img src="/files/fkxzv514zKYpFGabflnm" alt=""><figcaption><p>Fields to edit an existing custom skill</p></figcaption></figure>

2. Update the skill configuration.
3. Click **Save Changes**.

## Loading a custom skill

The Data Agent should automatically detect that the current context applies to a configured custom skill.

To manually load the skill:

1. In the chat prompt, click **Skills**.
2. In the **Skills** dropdown, click the skill to load.

## Deleting a custom skill

You delete a custom skill from the **Skills** page.

1. On the **Skills** page, click the custom skill to delete.
2. On the custom skill details, click **Delete**.


---

# Agent Instructions: 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.tonic.ai/fabricate/data-agent-tools/creating-and-using-custom-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.
