A Skill is how the agent acts. Knowledge is what the agent knows.Skills are the playbook. Knowledge is the reference.
The 5-second test
Ask: “Is this an instruction, or a fact?”- An instruction — “when X happens, do Y, then escalate to Z” → Skill
- A fact — “the policy is X” / “the answer is Y” → Knowledge
Would you hand this to a new employee on day one? → Knowledge Would you use it to train your best support agent on how to handle a case? → Skill
Both feed the agent — the difference is how
A common misconception is that Knowledge is “not for the agent.” It is — the agent searches your Knowledge Base on every relevant request. The difference isn’t agent vs. not-agent; it’s:- Skill — instructions the agent executes (behavior, procedure, when to run a workflow, internal routing the employee never sees).
- Knowledge — facts the agent cites (and that a person could read and simply understand).
Examples
| It’s a… | Because it’s… | Example |
|---|---|---|
| Knowledge | a fact a person looks up | PTO policy, laptop drop-off locations, office Wi-Fi password, benefits overview |
| Skill | a procedure the agent runs | ”For Prod access requests, run the grant-prod-access workflow, then notify the security channel” |
| Knowledge | reference, no action | ”Our VPN is Cisco AnyConnect; supported OSes are…” |
| Skill | behavior + an agent-only action | ”If a user reports VPN failure, check device posture, trigger reset-vpn-cert, then escalate to IT if it fails twice” |
The one-liner to remember
Knowledge is the textbook. A Skill is the playbook.
Still unsure? If it mentions a workflow the employee can’t run themselves, or relies on Serval-internal mechanics an employee wouldn’t understand, it almost certainly belongs in a Skill. If a new hire could read it and just know the thing, it’s Knowledge.
Learn more
- Skills overview — how to write instructions for the agent
- Knowledge Base overview — how to connect and author reference content

