Skill or SOP?
Rules of thumb:
- If it’s a judgment call about this process, it belongs in the SOP.
- If it’s a repeatable piece of work with a fixed output shape — a report format, a document template, a transformation you’d otherwise re-explain — make it a skill.
- If you find yourself pasting the same instructions into two different projects, that’s a skill.
What’s in a skill
A skill is a folder containing aSKILL.md file with the skill’s name and description, followed by the instructions themselves. Supporting files — scripts, templates, examples — live alongside it in the folder and the instructions point at them.
The name and description matter: they’re how the agent knows the skill exists and when to reach for it. “Weekly automation report — produces the ops summary xlsx from a reconcile table’s cases” is discoverable. “Report helper” is not.
Skills can carry secrets (an API key a script needs). Those are stored encrypted and injected as environment variables when the agent runs, so they never sit in the instruction text.
Managing skills
Skills are managed per project in the Customize panel (Connect in the sidebar), under the Skills tab, alongside Connectors and MCP Servers. You can:- Upload a skill folder containing a
SKILL.mdat its root. - Create one with the agent — describe the capability in the chat and have it write the skill.
SOPs
Process rules, as opposed to reusable capabilities.
MCP servers
The other way to extend what the agent can do.
