> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuralfactory.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Using skills

> Attach a skill to an agent, see how the agent uses it, and keep the skill up to date.

A skill is a written procedure, and an agent follows it only once the skill is attached to that agent. Attach it to the agents that do the task, and they follow it for everyone who uses them.

> [!NOTE]
>
> **Who:** Admins and Members attach skills they have access to, on agents they can change; only a skill's creator and Admins edit and publish it · **Where:** an agent's **What it knows** section, or **Knowledge** › **Skills** · **Works on:** Enterprise and SaaS

## Attach a skill to an agent

You can attach a skill from the agent or, while you create the skill, from the skill.

From the agent:

**1. Open the agent**

On **Agents**, click the agent. Only its creator and Admins can change it.

**2. Add the skill**

Click **Edit** on the **What it knows** section. Under **Skills**, click **Add skills...** and pick the skill; type in **Search skills...** to find it. Pick more than one if the agent does several kinds of task.

**3. Save and publish**

Click **Save changes**, then **Publish**. The people who use the agent get the change once you publish. See [Configuring agents](https://docs.neuralfactory.ai/user-guide/agents/configuring-agents.md).

From the skill, while you create it with NF: click **Attach this skill to an agent**, tick the agents in **Attach to Agents**, and click **Save**. Untick an agent there to take the skill away from it. This changes the published agent straight away, with no **Publish** step.

> [!TIP]
>
> The skill is listed under **Skills** in the agent's **What it knows** section, with its name below its title.

You can only attach skills you have access to. Once attached, the agent uses the skill for everyone who may use the agent, including people who cannot open the skill themselves.

### Skills on a subagent

A subagent is a specialist agent another agent hands part of its work to. You attach a skill to a subagent the same way. The main agent sees which skills each of its subagents has, so it can pass a matching request to the right subagent. See [Subagents](https://docs.neuralfactory.ai/user-guide/agents/multi-agent-workflows.md).

## What the agent does with a skill

The agent knows the name and description of every skill attached to it, but not their contents. When a request matches, it:

1. reads the skill's SKILL.md and follows its instructions;
2. opens the short reference files the instructions point to, such as a checklist;
3. copies scripts and templates into its workspace to run them or fill them in. Running a script needs **Code execution** among the agent's tools.

The agent decides from the name and description alone whether a skill applies. A description such as "Finance helper" says little. "Use when someone asks to check a supplier invoice before payment" tells the agent when to reach for it.

## Edit a skill

Open the skill from the **Skills** list (creator and Admins). The **Edit with NF** page works like creation:

* **Chat**: describe the change. NF sees all the skill's files and proposes edits, new files or deletions, which you **Apply**.
* **Files**: the **+** menu offers **Add Files**, **New Folder**, and **Replace from SKILL.md or zip**. Replacing uploads a new SKILL.md, or a zip whose files overwrite the ones with the same path; click **Replace & Save**. Drag a file onto a folder to move it. The buttons next to a file or folder add files to the folder or delete it. **SKILL.md** cannot be moved or deleted.
* **Preview**: edit text files directly. Word and Excel templates cannot be edited as text: download them, change them on your computer and add them again.

Your edits go into the draft. Agents keep using the active version until you publish.

## Publish a new version

**1. Publish**

In the editor, click **Publish**. The button shows while the skill was never published or has unpublished changes.

**2. Add a note**

In **Publish version**, describe what changed (optional), then click **Publish**.

> [!TIP]
>
> The version number in the editor header goes up, and the amber dot next to the skill in the list disappears.

To roll back, click **History**. **Version history** lists each version with its note, author, date, number of files and size, and marks the **Active** one. **View** shows a version's SKILL.md. Click **Activate** on the version you want, and agents use it from then on.

## Remove a skill

* **From one agent**: click **Edit** on the agent's **What it knows** section, click the cross next to the skill under **Skills**, click **Save changes**, then **Publish**.
* **Everywhere**: delete the skill from the **Skills** list (creator and Admins). It is removed from every agent that uses it.

## If something goes wrong

> [accordion] The agent does not use the skill
>
> Check that the skill is attached to the agent you are talking to, and that you clicked **Publish** on the agent after adding it. Then read the skill's description: the agent picks a skill from its name and description only, so say there when to use it. In [Interactions](https://docs.neuralfactory.ai/user-guide/governance/interactions.md), the record of the task shows the steps the agent took.

> [accordion] The agent follows the old instructions
>
> Once a skill has been published, agents use its active version. Publish your draft, or look in **History** for which version is **Active**.

> [accordion] The skill is missing from Add skills...
>
> You can only attach skills you have access to. Ask the skill's creator or an Admin to share it with you or make it **Public**.

> [accordion] Attach to Agents shows an error for an agent
>
> The message starts with "Failed to update" and the agent's name.
>
> * "Only admins and the creator can update this agent": you can attach skills only to agents you created, unless you are an Admin.
> * "This agent has unpublished changes in the studio; discard the draft to edit it here": publish or discard the agent's draft first, or add the skill from the agent itself.
>
> When the dialog says **No agents yet**, there is no agent to attach the skill to. [Create an agent](https://docs.neuralfactory.ai/user-guide/agents/creating-an-agent.md) first.

## Related

* [Skills](https://docs.neuralfactory.ai/user-guide/skills/overview.md): the list, built-in skills, who can do what and versions.
* [Creating a skill](https://docs.neuralfactory.ai/user-guide/skills/creating-a-skill.md): the ways to make a skill, the file rules and limits.
* [Configuring agents](https://docs.neuralfactory.ai/user-guide/agents/configuring-agents.md): every section of an agent.
* [Subagents](https://docs.neuralfactory.ai/user-guide/agents/multi-agent-workflows.md): agents that hand work to specialists.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.