What Are Skills?
Skills are reusable capability modules that agents can discover and run at runtime. Each Skill has a name, description, prompt instructions, and configured automation tools. Instead of wiring every automation into each agent manually, you build Skills once in the Skills Directory; agents then find and use them dynamically based on context.Skills Directory
App admins create and manage Skills under Intelligence → Skills. Per-Skill configuration:- Name and Description – How the skill is identified and when it should be used
- Prompt instructions – Instructions the agent follows when executing the skill
- Automation tools – One or more automations (e.g., On-Demand) that implement the skill’s behavior
| Status | Behavior |
|---|---|
| Draft | Not available to agents; use for work-in-progress |
| Active | Available to agents when skills are enabled |
| Disabled | Temporarily hidden from agents; can be re-enabled |
Enabling Skills on an Agent
In Agent Configuration, the enabledSkills setting controls whether and how the agent can use Skills.| Mode | Behavior |
|---|---|
| none | Agent has no Skills (default for new agents) |
| all | Agent can discover and use all active Skills in the app |
| selected | Admin picks specific skills from a checkbox table |
Auto-Injected Tools
When Skills are enabled (any mode other than none), the agent automatically receives tools—no manual tool setup is required: You do not add these tools yourself; they appear wheneverenabledSkills is not none.
Runtime Behavior
When an agent uses Skills, the flow is:- Search – The agent calls
skillSearchto find Skills relevant to the user’s request. - Details – For a chosen Skill, the agent calls
getSkillDetailsto load name, description, instructions, and automation wiring. - Execute – The agent runs the Skill’s behavior by invoking the underlying automation(s) via the Run Automation tool (e.g.,
runAutomation).
Testing Notes
- Only active Skills surface at runtime; disabled Skills do not.
- New agents default to none; enable Skills explicitly if you want the agent to use them.
- After changing a Skill’s status or an agent’s
enabledSkills, allow a moment for the agent to see the updated set.
Related Documentation
- Architecture – Agent platform, tools, and deployment; includes how Skills fit into the agent architecture.
- Building Agents – Create and configure agents, including tools and channels.