What problem does it solve? Documents written for AI agents often trigger unreliably, bloat the context window, or get ignored. This Skill provides a reference framework for writing any document an agent consumes—skills, AGENTS.md, CLAUDE.md, or pointer-reached docs—so the agent follows the same process every run. ## Core Features & Use Cases - Context pointer design: Rules for writing descriptions and pointer lines that front-load trigger words and list distinct branches, so agents reach material reliably. - Information hierarchy guidance: A ladder model (in-file steps, in-file reference, disclosed reference) plus progressive disclosure and co-location principles to fight document sprawl. - 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, use this reference to write a description that triggers on the right branches, prune no-op sentences, and decide between model-invoked and user-invoked invocation via the companion SKILL-MECHANICS.md file. ## Quick Start Ask the agent to review your draft skill or AGENTS.md file using the writing-for-agents principles and suggest improvements to its description and structure.
