> ## 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.

# Skills

> Write down how your team does a task once, and every agent you give it to follows the same steps.

A skill is a written procedure for one kind of task, such as checking an invoice or filling in a proposal. You write it once and give it to the agents (the AI assistants in Neural Factory) that do that task, and they follow it whenever a request matches.

> [!NOTE]
>
> **Who:** Admins and Members (Viewers do not see **Skills**) · \*\*Where:\*\***Knowledge** › **Skills** in the sidebar · **Works on:** Enterprise and SaaS

Two examples from office work:

* An "invoice-check" skill lists what your finance team checks on a supplier invoice: the purchase order number, the VAT rate, the bank details against the supplier record. Ask the agent to check an invoice and it goes through that list.
* A "client-proposal" skill holds your proposal template as a Word file and the rules for filling it in. Ask for a proposal for a new client and the agent starts from your template.

A knowledge base tells an agent what your documents say. A skill tells it how your team does a piece of work.

## What a skill is made of

Every skill has a file called **SKILL.md** with the instructions, written in Markdown (plain text with simple marks for headings and lists). It starts with a short header that gives the skill a **name** and a **description**. A skill can also hold extra files: examples, reference notes, scripts, or Word (`.docx`) and Excel (`.xlsx`) templates.

The agent reads the name and description to decide whether a request needs the skill, so write the description with care. [Creating a skill](https://docs.neuralfactory.ai/user-guide/skills/creating-a-skill.md) has the rules and an example.

## The skills list

The list shows every skill you have access to. Type in **Search skills...** to filter it, and point at a title to read the skill's description.

![The Skills list with one skill, Hr Letter Writer (hr-letter-writer), marked with an upload arrow and an amber dot, its file count, creator and creation date, and the Create Skill button.](https://mintcdn.com/neuralfactory/y-MI7aIFykaw0cY2/images/app/skills-list.png?fit=max\&auto=format\&n=y-MI7aIFykaw0cY2\&q=85\&s=3a2132031a4fcf4bc3555b9a7922a17a)

| Column | What it shows |
| - | - |
| **Name** | The skill's title, with its name below it. The title is made from the name: `customer-onboarding` shows as "Customer Onboarding". |
| **Files** | How many files the skill has. |
| **Created By** | Who created it, or "Neural Factory" for a system skill. Not shown in a SaaS personal account. |
| **Created At** | When it was created. |

Small marks next to the title tell you more:

| Mark | Meaning |
| - | - |
| Sparkle | **Created with NF**, the assistant that writes skills with you |
| Upload arrow | **Imported** from a file |
| Lock | **System skill**, provided by Neural Factory |
| **Public** badge | Everyone in the organization can use it |
| `v2` (or another number) | The active version agents use |
| Amber dot | **Unpublished changes**: the draft differs from the active version |

Click a skill to open it. Its creator and Admins open the editor. Everyone else gets a read-only view.

The menu at the end of each row offers:

* **Edit** (creator and Admins) or **View** (everyone else).
* **Export**: downloads the skill and its files as a `.zip`.
* **Duplicate**: makes a private, unpublished copy that belongs to you. See [Start from a copy](https://docs.neuralfactory.ai/user-guide/skills/creating-a-skill.md#start-from-a-copy).
* **Delete** (creator and Admins). Deleting a skill also removes it from every agent that uses it. When agents use it, the confirmation says how many.

## Built-in skills (Enterprise)

> [!NOTE]
>
> This section applies to Enterprise only. SaaS personal accounts and Business organizations start with no skills.

Every Enterprise organization gets two ready-made skills from Neural Factory:

* **Fill Docx** fills in a Word template, replacing placeholders and table cells while keeping the template's styles and layout.
* **Fill Pdf** fills in a PDF form.

They are marked with a lock and everyone in the organization can use them. Only Admins can change them. The **General** agent that every new organization starts with already has both attached. Both skills run small programs, so an agent that uses them needs **Code execution** among its tools. To make your own version of one, use **Duplicate**.

## Who can do what

| | Viewer (Enterprise) | Member | Creator of the skill | Admin |
| - | - | - | - | - |
| See **Skills** in the sidebar | No | Yes | Yes | Yes |
| Create, upload, duplicate and export skills | No | Yes | Yes | Yes |
| View a skill shared with them, and attach it to an agent | No | Yes | Yes | Yes |
| Edit, publish, roll back, change access, delete | No | No | Yes | Yes |

Viewers benefit from skills only through the agents they use. Admins have access to every skill in their organization.

* **Enterprise**: skills belong to the organization, so you can share a skill with users and groups.
* **SaaS**: in a Business organization, skills are shared as in an Enterprise organization. In a personal account, your skills are your own: there is no **Access** setting and no **Created By** column.

### Sharing a skill

Sharing works like it does for a knowledge base. Set it when you create the skill, or later with the **Access** button in the editor. You have two choices:

* **Private**, the default: only you and the users and groups you add under **Grant Access to Users** and **Grant Access to Groups**.
* **Public**: all organization members.

Having access lets a Member view, duplicate, export and attach the skill. Only its creator and Admins can change it.

## Versions

You always edit a skill's draft. Publishing turns the draft into a numbered version that cannot change afterwards, so you can keep working without affecting the agents that use the skill.

* A skill that was never published shows **Draft** in the editor, and agents use that draft.
* Once you publish, agents use the active version and keep using it while you edit the draft.
* **History** lists the published versions. **Activate** makes an older one active again, which is how you roll back.

Only the skill's creator and Admins can publish and activate versions. [Using skills](https://docs.neuralfactory.ai/user-guide/skills/using-skills.md#publish-a-new-version) has the steps.

## Related

* [Creating a skill](https://docs.neuralfactory.ai/user-guide/skills/creating-a-skill.md): write a skill with NF, upload one or copy one.
* [Using skills](https://docs.neuralfactory.ai/user-guide/skills/using-skills.md): attach a skill to an agent and keep it up to date.
* [Configuring agents](https://docs.neuralfactory.ai/user-guide/agents/configuring-agents.md): where an agent's skills are set.
* [Knowledge bases](https://docs.neuralfactory.ai/user-guide/knowledge-bases/overview.md): documents agents search for answers.


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