writing-for-agents is a model-invoked reference skill for writing documents an agent consumes: skills, AGENTS.md and CLAUDE.md files, and any doc reached by a pointer. It treats them as one kind of document, because the same levers make each predictable.
It covers how to word a context pointer, how to weigh context load against cognitive load, where each piece of content sits on the information hierarchy, and how to prune. A companion file, SKILL-MECHANICS.md, covers frontmatter, invocation choice and router skills.
What You Get
- A model-invoked skill that loads when you create or edit skills, AGENTS.md or CLAUDE.md
- Rules for wording context pointers, with one trigger per branch
- A framework for placing content in the file, in a sibling file or behind a pointer
- A pruning checklist covering duplication, stale lines and no-op sentences
- SKILL-MECHANICS.md for frontmatter, invocation choice and router skills
Common Use Cases
- Writing a new skill and choosing its description wording
- Trimming a bloated AGENTS.md or CLAUDE.md
- Deciding whether to split a long skill by sequence or by invocation
What Makes It Unique
Most skill-authoring guides cover file format. This one covers the writing itself: how pointer wording decides when material loads, how completion criteria prevent premature endings, and how leading words replace restated passages. It also separates the context load on the agent from the cognitive load on the human.
Under The Hood
The skill is two Markdown files and no scripts. SKILL.md holds the reference, with a description that tells the agent to load it when creating or editing skills or instruction files. SKILL-MECHANICS.md sits beside it and loads when the document being written is a skill. The skill reads and edits nothing by itself and runs no commands.