Skill

Represents the settings for a skill used for field service or to route chats to agents in Chat, such as the name of the skill and which agents the skills are assigned to.

This type extends Metadata and inherits its fields.

Skill values are stored in the <developer_name>.skill file in the skills directory.

Introduced in API version 28.0.

• Type: SkillAssignments
• Required: No
• Description: Specifies how skills are assigned to Chat users. Skills can be assigned to sets of users or sets of profiles.

• Type: string
• Required: No
• Introduced: API version 38.0
• Description: Specifies the description of the skill.

• Type: string
• Required: Yes
• Description: Specifies the name of the skill.

• Type: string
• Required: No
• Introduced: API version 58.0
• Description: Specifies the skill type, such as language or department, associated with the skill.

Represents which users and user profiles to whom specific skills are assigned.

• Type: SkillProfileAssignments
• Required: No
• Description: Specifies the profiles that are associated with a specific skill.

• Type: SkillUserAssignments
• Required: No
• Description: Specifies the users that are associated with a specific skill.

Represents the profiles that are associated with a specific skill.

• Type: string[]
• Required: No
• Description: Specifies the custom name of the profile associated with a specific skill.

Represents the users that are associated with a specific skill.

• Type: string[]
• Required: No
• Description: Specifies the username of the user associated with a specific skill.

This is a sample of a skill file.

1<?xml version="1.0" encoding="UTF-8"?>
2<Skill xmlns="http://soap.sforce.com/2006/04/metadata">
3    <label>My Skill 1</label>
4    <assignments>
5        <profiles>
6            <profile>LiveAgentOperator</profile>
7            <profile>LiveAgentSupervisor</profile>
8        </profiles>
9        <users>
10            <user>jdoe@acme.com</user>
11        </users>
12    </assignments>
13</Skill>

This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.