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.
The skill is listed under Skills in the agent’s What it knows section, with its name below its title.
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:- reads the skill’s SKILL.md and follows its instructions;
- opens the short reference files the instructions point to, such as a checklist;
- 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.
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.
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.
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
The agent does not use the skill
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, the record of the task shows the steps the agent took.
The agent follows the old instructions
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.
The skill is missing from Add skills...
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.
Attach to Agents shows an error for an agent
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.
Related
- Skills: the list, built-in skills, who can do what and versions.
- Creating a skill: the ways to make a skill, the file rules and limits.
- Configuring agents: every section of an agent.
- Subagents: agents that hand work to specialists.