Writing for Agents

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

This skill is imported from mattpocock/skills (MIT) and is model-invoked upstream.

When to use this skill

• Writing documents for agents.
• Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Instructions

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

When the document you're writing is a skill, read references/SKILL-MECHANICS.md for frontmatter, invocation choice, and router skills.

Context pointers