Skip to main content
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.
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.
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.
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.

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

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, the record of the task shows the steps the agent took.
Once a skill has been published, agents use its active version. Publish your draft, or look in History for which version is Active.
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.
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 first.