Enterprise Search
Logo
Skills

Skills

Logo

2 mins read READ

Skills are reusable expertise that teach your Enterprise Search agent how to handle specific work — like generating slides, spreadsheets, or images. A skill is guidance and know-how, not a callable function: where a tool lets the agent do something, a skill shapes how it reasons and responds.

es-fix_skills_drawer.png
es-fix_skills_drawer.png

What is the Skills section?

The Skills table lists the skills attached to the Enterprise Search agent. Add ones from the shared skill library with Add skill.

Skills aren't the same as Capabilities: capabilities are built-in functions you switch on, such as Image Generation or Create PPTX, while a skill is guidance the agent follows when it does that kind of work. The two work together.

How do I add a skill?

Use Add skill to open the picker, search the skill library, select one or more skills, and click Add. Only published skills can be attached — a skill has to be deployed before it shows up as available. If everything is already attached, or nothing is published yet, you'll see No skills to add — "Every skill is already added to this agent, or you haven't created any yet." Skills are built and published in the platform's Skills library, where a skill shows Draft until it's published and Live after. If the skill you need isn't in the picker, create or publish it there first, then come back and use Add skill again.

What's in the skills table, and how do I remove a skill?

Each row shows the Skill name, its Description, and its Version (a V{n} pill showing the skill's current published version, or a dash if it's never been deployed). The picker only offers published skills, but the table lists every skill linked to this agent, including any linked from somewhere other than the picker — so a never-deployed skill can still appear here with a dash; publish it from its editor. Hovering a row reveals a small external-link icon after the skill name: clicking it opens that skill's own editor in a new browser tab, so you can change the skill without losing your place in Enterprise Search. Clicking the row itself opens the read-only preview instead.

To detach a skill, use Remove on its row — the confirmation reads Remove skill? — "'{name}' will be removed from this agent. The skill itself won't be deleted." — so it stays available for other agents. If none are attached yet, the empty state reads No skills added yet — "Add reusable skills that teach this agent how to think and respond."

What does attaching a skill actually do at run time?

Attaching grants the Enterprise Search agent access to the skill — the skill asset itself is shared, never copied, which is why removing it here doesn't delete it. At run time the agent sees each attached skill's name and description in a built-in skill-loading tool, and pulls in the full guidance only when a request matches, so attach freely: unused skills cost nothing until they're relevant. Skill names must be unique per agent — adding a second skill with the same name is rejected. Skills shared with the current user or their teams, and skills shared with everyone, are also available alongside the ones attached here. Adding or removing a skill takes effect from the agent's next request: attachments aren't part of the agent's published configuration, so you don't need to Publish the agent for them. The agent uses the skill's published content, so after you edit a skill, publish it again for the agent to pick up the change.

FAQs

Can I preview a skill before adding it?

Yes. Use View on a skill to open a read-only preview of its written guidance and any files, along with when it was last updated. Preview a skill to confirm it teaches the behavior you want before attaching it, then add it from the same view.

What does attaching actually do at run time?

Attaching grants the Enterprise Search agent access to the skill — the skill asset itself is shared, never copied, which is why removing it here doesn't delete it. At run time the agent sees each attached skill's name and description in a built-in skill-loading tool, and pulls in the full guidance, plus a listing of the skill's files, only when a request matches. That means:

  • You can attach freely — unused skills cost the agent nothing until they're relevant.

  • The description decides whether the agent recognizes when to use the skill, so keep it specific.

  • Skill names must be unique per agent — adding a second skill with the same name is rejected.

Skills shared with the current user or their teams, and skills shared with everyone, are also available to the conversation alongside the ones attached directly here.

Why does the skill picker show No skills to add?

This appears when every available skill is already attached to the agent or when no published skills are available. Only published skills can be attached.