Skills
A skill is a block of reusable instructions, such as how to greet a caller, how to hand over to a person or how to book an appointment. You write it once in the project and attach it to every agent that needs it. An attached skill is loaded into every conversation the agent has, on every channel.
Skills must be included in your organization's plan. If an agent has skills attached and the plan doesn't include them, the agent's conversations are refused until you detach the skills or change the plan.
Create a skill
-
In the project sidebar, choose Connect → Skills.
-
Choose New skill.
-
Fill in the fields:
Field Limit What it does Name Required, up to 100 characters How agents and teammates recognise the skill. Description Up to 500 characters What the skill does. Instructions What the agent does whenever the skill is active. Write them as steps. Tags Comma-separated Help you filter skills, for example support, returns. -
Choose Save.
To draft the instructions, describe what you want in the Generate box and choose Go. Review the result before you save.
Start from a reference skill
Choose Reference skills on the Skills page to browse ready-made skills. Preview one to see its instructions and the tools it calls, then choose Use this skill to add a copy to your project. You can edit the copy.
| Reference skill | What it does | Tools it needs |
|---|---|---|
| Customer Greeting | Warm, professional greeting with an offer to help. | None |
| Human Escalation | Gracefully hand off to a human agent when needed. | None |
| Formal Communication Style | Keep a formal, professional tone. | None |
| Tool Boundary Enforcement | Stops the agent from claiming actions or using tools that aren't connected. | None |
| Appointment Booking | Book, reschedule and cancel appointments. | Google Calendar |
| Calendar Check | Check what's on the calendar for a time range. | Google Calendar |
| Contact Lookup | Find contacts by name or email. | Google Contacts |
| Schedule Meeting with Contact | Look up a contact, then schedule a Google Meet with them. | Google Contacts, Google Calendar |
| Document Lookup | Search Google Drive for files and answer questions about them. | Google Drive |
| Support Ticket Routing | Route support and issue reports to Freshdesk. | Freshdesk |
Connect the tools a skill needs under Connect → Tools before an agent uses it.
Attach a skill to an agent
- Open the agent and choose Skills.
- Tick each skill you want. It's attached straight away.
Untick a skill to detach it. Attaching and detaching needs Contributor access.
The skill's page shows which agents use it, how often it has been used and when it was last used.
Reference tools in a skill
To make a skill call a tool, write {{tool:tool_name}} in its instructions:
When the caller asks about an order:
1. Ask for the order number.
2. Use {{tool:lookup_order}} to get the order status.
3. Read the status back in one sentence.
When the agent runs, the reference is replaced with the tool's description. The skill page lists every tool the instructions reference and shows NOT FOUND for any tool that isn't in the project. The agent can only call tools that are connected to it, so connect the tool to the agent as well.
Use the knowledge base in a skill
If the agent has a knowledge base attached, a skill can tell it to search there before it answers. You don't need a tool reference for this:
Search your knowledge base for relevant documentation before answering.
If you find a relevant answer, share it and ask if it resolves the question.
Delete a skill
Open the skill and choose Delete skill. Agents that use it lose it immediately.