What problem does it solve? Documents written for AI agents often produce inconsistent behavior: agents skip steps, finish early, or ignore reference material. This Skill provides a reference framework for writing agent-consumed documents so the agent follows the same process every run. ## Core Features & Use Cases - Context pointer design: Write descriptions and pointer lines whose wording reliably triggers the agent to reach out-of-context material at the right branch. - Information hierarchy and progressive disclosure: Place steps and reference on the right tier — in-file steps, in-file reference, or disclosed reference behind a pointer — to prevent sprawl and buried instructions. - Completion criteria and splitting: Define clear, demanding completion criteria for each step, and split documents by sequence or invocation to prevent premature completion. - Use Case: When authoring a new skill or editing an AGENTS.md file, apply the pruning rules (single source of truth, no-op detection, leading words) to keep the document short, relevant, and behavior-changing. ## Quick Start Ask the agent to review your draft skill or AGENTS.md file using the writing-for-agents guidance and suggest pruning and pointer improvements.
