Instructions, Skills or AGENTS.md: where should a rule go?

Three places can carry instructions, and they are not interchangeable:

Layer Scope Put here
Instructions This agent only What this agent is and does
Skills Any agent in the same project Reusable rules of practice: rounding, dates, tone, when to refuse
AGENTS.md Every agent that points at the file Standing facts about your organisation and systems

A quick test: if a second agent would need the same rule, it is a skill. If it is true for everything in the workspace, it goes in AGENTS.md.

Using AGENTS.md: in Agent Studio open the Context group (on the canvas, the Agent Node’s Agent Instruction tab) and set AGENTS.md Source to path, then Choose .md File. Prefer path over inline: one file, edited once, read by many agents.

Keep AGENTS.md short. It rides along on every model call, so it costs tokens on every run. And remember it supplies context only; it does not grant permissions. Tools, MCP servers and guardrails still decide what the agent can do.

Docs: Context & AGENTS.md · Skills