Agent skill · forcedotcom
service-omni-work-skill-routing-configure
Use to author an Omni WorkSkillRouting rule (field-based skill criteria): map a related-entity field value to a required Omni Skill (e.g. add the Voice skill when Case.Origin = Phone), deployed as one WorkSkillRouting record via the Metadata API. Idempotent via the Metadata API files[].state signal; one rule per related entity. Triggers: add field-based skill routing, route by a Case field to a skill, route by a MessagingSession field to a skill, configure attribute-based skills routing, require an Omni skill for a field value. Do not use to create the Skill or bind agents to it (service-omni-skills-based-routing-configure), to create agent users, or to configure queues.
What it needs
About 3k tokens when loaded.
What this skill does
service-omni-work-skill-routing-configure Author an Omni WorkSkillRouting rule so work is routed to agents by a field value on the work record, not just by skills the agent happens to hold. Where service-omni-skills-based-routing-configure makes an agent routable (Skill + ServiceResource + ServiceResourceSkill), this skill decides which skill a work item requires based on one of its fields — for example "when Case.Origin = Phone, require the Voice skill". The rule is one WorkSkillRouting record (a header plus one workSkillRoutingAttributes mapping) deployed via the Metadata API. It runs after the referenced Skill exists and belongs to the same routing family coordinated by service-omni-channel-setup-coordinate. Inputs org-alias (required). relatedentity (required). The sObject the rule applies to (e.g. Case, MessagingSession, LiveChatTranscript, Lead, VoiceCall). field (required). The field the attribute evaluates (e.g. Case.Origin or Origin). Bare standard fields are qualified with the related entity before deploy, so Origin becomes Case.Origin instead of being misread as a custom-field metadata name. skill (required). The Omni Skill DeveloperName required when the field matches (e.g. Voice). value (required). The field value that maps to the skill (e.g. Phone). Plain values only; XML-reserved characters are not supported. rulemasterlabel (optional). MasterLabel for the rule; defaults to <relatedentity> Skill Routing. Env overrides: RULEDEVELOPERNAME (fullName of the rule, default the related-entity name — one rule per entity), ISACTIVE (default true), SKILLLEVEL (0–10), SKILLPRIORITY (0–10, additional-skill drop order), ISADDITIONALSKILL (true/false). Preconditions and safety Target org authenticated via sf CLI, Service Cloud license, sf CLI ≥ 2.139.6. Omni-Channel base settings enabled with skills-based routing turned on (service-omni-base-settings-configure). The referenced Skill already exists (service-omni-skills-based-routing-configure). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills forcedotcom/service-omni-work-skill-routing-configure--b4cd85