How to Set Up Skills Based Routing
Table of Contents
Overview
Skills-based routing gets each call to the right agent the first time.
It works by matching what the call needs with what your agents are good at. The system then chooses the best available agent based on their skill level.
This means fewer transfers, faster handling, and better customer outcomes.
How skills work in Cirrus Halo
Each agent can have one or more skills.
Every skill is given a rating from 9 to 1:
- 9 = highest skill level
- 1 = lowest skill level
When a call is routed, Cirrus Halo will:
- Look for agents with the required skill
- Offer the call to agents with the highest skill level first
- Only move to lower skill levels if no higher-skilled agents are available
This ensures your most capable agents handle the most relevant contacts.
When to use skills-based routing
Use this when calls need to go to specific agents based on:
- language
- department
- product knowledge
- technical ability
- a mix of skills
Setting Up Skill-Based Routing
Skill requirements are defined when linking a module to a Router.
They are set using the Parameter1 and Parameter2 fields in the linking configuration.
Implementation Steps
1. Create Skills
- Go to Settings → Skills.
- Select Add Skill and define the required skill names (e.g. “Hardware”, “French”, “Sales”).
- Add a Language Code if the skill is being used for email routing.
Skill Language Code
The language code on a skill is only used for email routing, not voice. It tells Cirrus Halo which language an email is written in so it can match it to the right agents. If you are using skills for voice routing, the language code is ignored. Instead, the system relies on the skill name, which must match the language set in your PBX exactly. For example, if your PBX language is set to French, your skill must also be named French for routing to work. Only add a language code when you are setting up email routing rules that use language as a condition. If you are not routing emails by language, you can leave this field empty.

2. Assign Skills to Agents
- Open Agents
- Assign each agent the relevant skills and a rating value between 1 and 9.
9 = highest skill level
1 = lowest skill level

Skill Configuration in the Supervisor portal

Supervisors (if allowed via permissions) can configure and manage agent skills in a very user friendly manner as shown above.
3. Configure the Router
- Open the Router you want to use.
- Define the Minimum Skill Score — the lowest acceptable skill rating for receiving routed calls.

4. Link Skills in the Transfer Module
- Open the linking module connected to your Router.
- In Parameter1, select the primary skill.
- Optionally, in Parameter2, define a secondary skill.
- Save your changes.

Example: Helpdesk Configuration
In this example, a single Helpdesk Router handles both Hardware and Software enquiries.
Call Flow
- All callers dial the same number.
- A Menu module offers:
- Press 1 for Hardware problems
- Press 2 for Software problems
- Both options route to the same Router (Helpdesk).
- Routing depends on the skill configured in the linking module.
Configuration Steps
- Open the Menu module.
- Select the menu option triggered by “1 – Hardware.”
- Click Link and choose the Router module.
- Select the Helpdesk Router.
- In Parameter1, select “Hardware.”
- Click OK to save.
- Repeat the process for menu option “2 – Software,” using “Software” as Parameter1.

Using Two Skills
For more complex routing, you can define two skills using Parameter1 and Parameter2.
This allows for combinations like Language + Technical Knowledge or Product + Department.
💡 Tip: Dual-skill routing is ideal for international or specialised teams where both skills influence call handling.
Important
Skills are only applied during transfer to the Router.
If a call is redirected or requeued, reapply the skills using LAST USED SKILL 1 and LAST USED SKILL 2.
How Skill Ratings Work
Routing decisions are based on four key factors:
| Factor | Description |
|---|---|
| Skill Mandatory Flag | Determines whether a skill is required for routing. |
| Agent Skill Rating | The agent’s score for each skill. |
| Router Minimum Skill Score | The minimum acceptable skill rating per Router. |
| Single or Dual Skill Routing | Defines how one or two skills are applied to routing decisions. |
Routing Scenarios
| Scenario | Requirement | Routing Logic |
|---|---|---|
| One Skill | Skill is required | Agent must have the skill and meet the minimum score. |
| Two Skills (Both Mandatory) | Both required | Agent must hold both skills and meet the minimum for each. |
| Two Skills (One Mandatory) | One required | Agent must have both skills; average score must meet or exceed the minimum. |
| Two Skills (Neither Mandatory) | Optional | Agent must have both skills; average score across both must meet or exceed the minimum. |
Additional Considerations
- Cirrus always routes to the highest-rated available agent first.
- If no agents meet the minimum skill requirement, the No Agent Exception rule applies.
- Be mindful that highly rated agents may receive more calls. Consider distributing skill ratings evenly across your team.
⚙️ Best Practice: Review skill ratings regularly to maintain balanced workloads and fair routing.
Summary
Skill-Based Routing enables precise call distribution based on agent expertise.
When configured correctly, it ensures customers reach the most capable agents first, improving efficiency and satisfaction.
Next Steps:
- Review your current skill assignments.
- Test your Router setup using a sample call.