What problem does it solve? Documents written for AI agents often fail unpredictably: weak descriptions never trigger, bloated files dilute attention, and vague steps invite premature completion. This Skill provides a systematic reference for writing agent-consumed documents so they behave predictably on every run. ## Core Features & Use Cases - Context pointer design: Rules for writing skill descriptions and AGENTS.md lines that reliably trigger the right material at the right branch. - Information hierarchy: A ladder model (in-file steps, in-file reference, disclosed reference) for deciding what to inline versus push behind a pointer, plus co-location and sprawl guidance. - Completion criteria and splitting: Techniques for writing checkable, exhaustive step boundaries and deciding when to split documents by sequence or invocation. - Use Case: When authoring a new skill or editing a CLAUDE.md file, apply the leading-word, pruning, and negation-avoidance rules to produce a document the agent follows consistently. ## Quick Start Ask the agent to review your draft skill or AGENTS.md file using the writing-for-agents guidelines and suggest improvements to its description and structure.
