Agent Skill

How it works in practice

A support-triage agent holds three skills: search the knowledge base, classify a ticket by urgency, and draft a reply. The first is a thin wrapper over a vector search. The third is a packaged procedure that pulls the customer's history, applies a tone template, and returns a draft. When a ticket arrives, the agent definition picks which skills to invoke and in what order. Add a fourth skill later, escalate to a human, and every agent that references it gains the capability without rewriting the others. The skill is defined once and reused across definitions.

Agent skill vs. its neighbours

• Feature⭐FeatureProduct SpecificationA product capability or featureView reference → is a capability of the product offered to its users; an agent skill is a capability the agent uses to do its work. A skill often wraps or builds on a feature, which the graph records directly.
• Agent definition holds the configuration and decides which skills to call. The skill is the verb; the definition is the actor that chooses among the verbs.
• Agent task🎫Agent TaskWorkflows & AgentsA discrete unit of agent workView reference → is a unit of work to be completed, which may require several skill invocations. A skill is a single move; a task☑️TaskProduct SpecificationA unit of work within a story or epicView reference → is the job🔨JobUserJob To Be Done: what the user is trying to accomplishView reference → that strings moves together.

In the graph

In the Unified Product Graph, an agent skill lives in the automation region and is reachable from its agents through agent_definition_capable_of_agent_skillAgent Definitioncapable ofAgent Skillhierarchy. When a skill is built on top of something users already see, agent_skill_extends_featureAgent SkillextendsFeaturecross-domain ties it back to the feature⭐FeatureProduct SpecificationA product capability or featureView reference → it draws on, which keeps agent capability and product capability from drifting apart. Modelling skills as their own entities, rather than burying them inside each definition, means a skill is countable, shareable, and auditable: you can ask which agents can do a given thing, and which product feature a given skill depends on.