What problem does it solve? Documents written for AI agents often fail unpredictably: bloated files bury key steps, weak descriptions never trigger, and duplicated rules drift out of sync. This Skill provides a reference framework for writing any document an agent consumes so the agent follows the same process reliably on every run. ## Core Features & Use Cases - Context pointer design: Rules for writing skill descriptions and AGENTS.md lines that trigger reliably, with front-loaded leading words and one trigger per branch. - Information hierarchy: A ladder model (in-file steps, in-file reference, disclosed reference) plus progressive disclosure and co-location to keep documents legible. - Completion criteria and splitting: Guidance on writing checkable, exhaustive step completion criteria and deciding when to split documents by sequence or invocation. - Use Case: When creating a new agent skill or editing a CLAUDE.md file, apply the pruning rules (single source of truth, no-op detection, negation avoidance) to produce a tighter, more predictable document. ## Quick Start Ask the agent to review your draft SKILL.md or AGENTS.md using the writing-for-agents guidelines and suggest improvements.
