What problem does it solve? Documents written for AI agents often fail unpredictably: agents miss referenced material, rush steps, or get lost in bloated files. This Skill provides a systematic reference for writing any document an agent consumes so the agent follows the same process every run. ## Core Features & Use Cases - Context pointer design: Rules for writing descriptions and references that reliably trigger the agent to reach out-of-context material, with branch-based trigger wording. - Information hierarchy and progressive disclosure: A ladder model (in-file steps, in-file reference, disclosed reference) for deciding where each piece of content lives, plus co-location and sprawl guidance. - Completion criteria and splitting: Techniques for writing checkable, exhaustive step completion criteria and deciding when to split documents by sequence or invocation. - Use Case: When authoring a new skill or editing an AGENTS.md file, consult this reference to prune no-op instructions, choose leading words, and structure pointers so the agent behaves consistently. ## Quick Start Ask the agent to review your draft skill or AGENTS.md file using the writing-for-agents guidance and suggest improvements to its pointers and structure.
