Skip to content

Skills

A folder in a Team's skills/ is one skill package, instructions, scripts and Templates, that a Role's agent loads.

A folder in agents/[team]/skills/ is one skill package: instructions, scripts and Templates that a Role's agent loads when its work calls for them.

  • agents/customer/skills/
  • renewal-call/
  • SKILL.mdwhen to use it, and how
  • script.mdthe call script

Reference

SKILL.md is Markdown with frontmatter. Other files in the folder are read on demand.

KeyTypeHolds
namestringThe skill's name
descriptionstringWhen the agent should load it
rolesRole pathsThe Roles that may load it; the Team's by default

Examples

Minimal

agents/customer/skills/renewal-call/SKILL.md
---
name: renewal-call
description: Call a resident who has not answered a renewal notice.
---

Leaseline

agents/customer/skills/renewal-call/SKILL.md
---
name: renewal-call
description: Call a resident who has not answered a renewal notice after seven days.
roles: [customer/success-manager]
---
1. Read the lease and the notice that went out.
2. Follow script.md. Confirm the end date and the new rent.
3. Record the answer with Lease.update.

What it builds

The StartupBuilder versions the folder with the Role's eval cases.

  • a skill Version the agent loads by name
  • a Change per edit, checked against the Role's tests

Good to know

  • A skill is instructions, not a Permission. The Role's Mandate still bounds every call.