What an agent knows
Skills
A skill is a markdown file — usually SKILL.md — plus whatever it references. It is knowledge, written down, in a place the agent will read it.
Concretely, the ones teams write most often:
- How your month-end close works, step by step, with the actual account names.
- The house style for a database migration, including the two things nobody remembers.
- The tone support replies in, and the three phrases you never use.
- What your on-call runbook says, so the agent stops inventing one.
Skills are portable. Any client that reads SKILL.md can use one, which is why the format is worth staying inside rather than inventing something proprietary.