> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/skills/skills-management.md).

# Skills Management

{% hint style="info" %}
If you're not yet familiar with what skills are, please read: [Skill Overview](/maiagent-user-guide/maiagent-user-guide-en/skills/skill-overview.md)
{% endhint %}

## Creating Skills

Click <mark style="color:blue;">Skills</mark> in the left sidebar to enter the skills management page, then click the <mark style="color:blue;">Add Skill</mark> button in the upper right corner.

The system provides two creation methods:

### Method 1: Manual Creation

Suitable for writing skill instructions from scratch.

1. In the add skill dialog, click the <mark style="color:blue;">Switch to manual creation</mark> link at the bottom to switch to manual mode
2. Fill in the <mark style="color:blue;">Basic Settings</mark> tab:
   * **Skill Name** (required): Give the skill an easily identifiable name
   * **Description** (required): Briefly describe the skill's purpose
3. Switch to the <mark style="color:blue;">Instructions</mark> tab and write instructions in Markdown format. You can also click the <mark style="color:blue;">Apply Template</mark> button to use a system-provided default template as a starting point
4. (Optional) Switch to the <mark style="color:blue;">Attached Tools</mark> tab to select the tools required by the skill
5. Click <mark style="color:blue;">Save</mark> to complete creation

### Method 2: Upload Skill Package

Suitable for importing pre-packaged `.skill` or `.zip` files.

1. In the add skill dialog (upload mode by default), drag and drop the `.skill` or `.zip` file into the upload area, or click the area to select a file
2. After the upload is complete, the system automatically parses the `SKILL.md` file to extract the skill name, description, and instructions
3. After successful creation, you are automatically redirected to the edit page where you can further adjust the settings

{% hint style="info" %}
The skill package must contain a `SKILL.md` file in the following format:

```markdown
---
name: Skill Name
description: Skill Description
---

This is where the AI assistant's execution instructions go...
```

{% endhint %}

***

## Editing and Configuring Skills

In the skill list, click the <mark style="color:blue;">Edit</mark> icon for the skill to enter the skill settings page.

### Basic Settings

Edit the skill's name and description.

### Instructions

Edit the skill instructions in Markdown format. These instructions serve as the execution guide when the AI assistant activates the skill.

Click <mark style="color:blue;">Apply Template</mark> to load a default instruction template.

{% hint style="warning" %}
Applying a template will overwrite the current instructions. Please confirm before proceeding.
{% endhint %}

### Skill Package (Upload-created skills only)

If the skill was created by uploading a `.skill` / `.zip` file, this tab displays:

* **Skill package info**: File name, size, upload time
* <mark style="color:blue;">Preview</mark>: Expand to view the file structure within the skill package
* <mark style="color:blue;">Download</mark>: Export the skill package file
* <mark style="color:blue;">Re-upload skill package</mark>: Upload a new version to replace the existing skill package

### Attached Tools

Bind the required tools to the skill so the AI assistant can call them when executing the skill.

1. Click the <mark style="color:blue;">Select Tools</mark> button to open the tool selection dialog
2. Check the tools to attach (multiple selection supported), then click Confirm
3. Selected tools appear in the list, showing the tool name, type (API / MCP), and description
4. To remove a tool, click the delete icon on the tool card

After completing the configuration, click the <mark style="color:blue;">Save</mark> button in the lower right corner of the page.

***

## Exporting Skills

In the skill edit page's <mark style="color:blue;">Skill Package</mark> tab, click the <mark style="color:blue;">Download</mark> button to export the skill as a `.skill` file.

{% hint style="info" %}
Manually created skills can also be exported. The system automatically packages the instructions and resources into a `.skill` file. Exported skill packages can be shared with other organizations for import.
{% endhint %}

***

## Binding Skills to an AI Assistant

Skills must be bound to an AI assistant to take effect:

1. Go to the <mark style="color:blue;">AI Assistant</mark> page, select the target AI assistant, and enter its settings
2. Find the <mark style="color:blue;">Skills</mark> setting in the model configuration area
3. Select the skills to bind and click Confirm
4. Save the AI assistant settings

Once bound, the AI assistant automatically determines whether to activate a skill based on the user's question during conversations and executes the corresponding task according to the skill instructions.

***

## Deleting Skills

In the skill list, click the <mark style="color:blue;">Delete</mark> icon for the skill, then confirm to delete it.

{% hint style="warning" %}
After deleting a skill, AI assistants that had this skill bound will no longer be able to use it. This action cannot be undone.
{% endhint %}


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/skills/skills-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.