Writing For Agents

Reference for writing any document an agent consumes: a skill, an AGENTS.md, a doc reached by a pointer. The packaging differs; the writing does not: the same levers make each one predictable, because the agent takes the same process every run rather than producing the same output.

When the document is a skill, read SKILL-MECHANICS.md for frontmatter, invocation, and descriptions.

Context pointers

A context pointer is a reference held in the agent's context that names material outside it and encodes the condition for reaching it. A skill's description is one; so is a line in AGENTS.md naming a doc. The pointer's wording, not the target, decides whether the agent reaches the material.