Skill

Introduction

Agivar can use Skill files to describe its product capabilities to external AI clients. A Skill is essentially a user guide for AI: it tells an AI client what Agivar can do, how it should be invoked, how tasks flow, and how to handle exceptions.

If an AI client supports Skills or custom skills, importing the SKILL.md provided by Agivar helps the client understand Agivar's desktop task capabilities more reliably. It can then follow the recommended process to connect to MCP, start tasks, poll for results, inspect screenshot evidence, and provide follow-up instructions.

A Skill does not execute tasks by itself. Desktop operations are actually performed by Agivar's built-in MCP service. The Skill reduces the effort required for an AI client to understand and use Agivar, making it clearer when to invoke Agivar, how to invoke it, and how to determine whether a task is complete.

Skill files

SKILL.md is a capability description intended for an AI client to read. It does not connect to Agivar directly and does not replace MCP configuration. Instead, it tells the AI client which desktop tasks are suitable for Agivar, which process to follow when calling Agivar MCP tools, how to determine whether a task is complete, and how to handle exceptions.

If your AI client supports Skills or custom skills, importing Agivar's SKILL.md helps the client choose Agivar more reliably when a task requires real desktop interaction. It can then start tasks, poll for results, continue a conversation, cancel tasks, and inspect screenshot evidence using the recommended approach.

A Skill file typically explains:

• which types of tasks are suitable for Agivar;
• which types of tasks are not suitable for Agivar;
• how to write an effective task description;
• the recommended sequence for calling tools;
• how to continue a conversation, cancel a task, and read its results;
• how to use the summary, observation records, and screenshots to determine whether a task is complete;
• important considerations when using Agivar.

Where to find Skills

Open Agivar, click the Settings icon next to the profile area in the left sidebar, select Extension Center from the menu, and then click the Skills tab at the top.

The Extension Center has two tabs: Skills and MCP. Use the Skills tab to view, install, enable, disable, or delete Skills. Use the MCP tab to manage MCP-related configuration.

Install a Skill

In the Skills tab of the Extension Center, click + Install Skill in the upper-right corner, then select the folder that contains SKILL.md. After installation succeeds, the Skill appears in the Skill list.

When installing a Skill, select its folder rather than the individual SKILL.md file. A standard Skill folder must contain a SKILL.md file. For example, a folder named my-skill should contain one SKILL.md file.

After installation, Agivar reads the instructions in SKILL.md and makes them available to the Agent when needed.

Find configured Skills

In the Skills tab of the Extension Center, you can find installed Skills using search, filters, and view options.

If you know a Skill's name or a relevant keyword, enter it in the search box, such as pdf, docx, xlsx, or paper. The list automatically filters to matching Skills.

To the right of the search box are three filters: All, Built-in, and Local. All shows every installed Skill; Built-in shows only Skills included with Agivar; Local shows only Skills installed locally by the user. Each Skill card also displays a source label, such as Built-in or Local, so you can identify where it came from.

On the right side of the page, you can switch between grid view and list view. Grid view presents Skills as cards and is useful for quick browsing. List view is better when you have many Skills to review.

Enable and disable Skills

Each Skill card has its own switch in the upper-right corner. When the switch is on, the Skill is enabled and can be used by the Agent. When the switch is off, the Skill is disabled and the Agent will not use it.

The upper-right corner of the page also contains a master switch that controls whether any Skills can be used. When the master switch is on, Skills are allowed. When it is off, all Skills are suspended. Even if an individual Skill's switch is on, that Skill does not take effect while the master switch is off.

To disable only one Skill temporarily, turn off the switch on its card. To disable all Skills temporarily, turn off the master switch.

Delete a Skill

Click the delete icon on a Skill card to remove that Skill.

After deletion, the Skill no longer appears in the list and the Agent can no longer use it. Whether a built-in Skill can be deleted depends on the options shown in the interface.

Skill card reference

Each Skill is displayed as a card. The card shows the Skill's name, source, description, delete action, and enabled state.

1. Skill name: identifies the Skill, such as docx, pdf, or xlsx.
2. Source label: indicates whether the Skill is Built-in or Local.
3. Description: briefly explains which tasks the Skill is designed to handle.
4. Delete button: removes the Skill.
5. Enable switch: controls whether the Agent can use the Skill.

FAQ

The Skill does not appear after installation

First, make sure you selected the folder containing SKILL.md, rather than selecting the SKILL.md file itself. Also confirm that the filename is exactly SKILL.md.

If the folder and filename are correct, check that you are on the Skills tab rather than the MCP tab. You can also clear the search box or switch the filter to All in case the Skill is hidden by a search term or filter.

The Skill is installed but does not take effect

• Confirm that the switch in the upper-right corner of the Skill card is on, then confirm that the master switch in the upper-right corner of the page is also on.

• If both switches are on, make sure the current task matches the Skill's intended use. The Agent selects Skills automatically based on the task. If the task does not match the Skill's description, the Agent may not use it.

• If the Skill still does not take effect, try restarting Agivar.