Skip to main content

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.

note

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​

  1. In the project sidebar, choose Connect → Skills.

  2. Choose New skill.

  3. Fill in the fields:

    FieldLimitWhat it does
    NameRequired, up to 100 charactersHow agents and teammates recognise the skill.
    DescriptionUp to 500 charactersWhat the skill does.
    InstructionsWhat the agent does whenever the skill is active. Write them as steps.
    TagsComma-separatedHelp you filter skills, for example support, returns.
  4. 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 skillWhat it doesTools it needs
Customer GreetingWarm, professional greeting with an offer to help.None
Human EscalationGracefully hand off to a human agent when needed.None
Formal Communication StyleKeep a formal, professional tone.None
Tool Boundary EnforcementStops the agent from claiming actions or using tools that aren't connected.None
Appointment BookingBook, reschedule and cancel appointments.Google Calendar
Calendar CheckCheck what's on the calendar for a time range.Google Calendar
Contact LookupFind contacts by name or email.Google Contacts
Schedule Meeting with ContactLook up a contact, then schedule a Google Meet with them.Google Contacts, Google Calendar
Document LookupSearch Google Drive for files and answer questions about them.Google Drive
Support Ticket RoutingRoute 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​

  1. Open the agent and choose Skills.
  2. 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.

Was this page helpful?