What problem does it solve? Documents written for agents often fail unpredictably: weak descriptions never trigger, bloated files bury key steps, and vague completion criteria let agents stop early. This Skill provides a reference of writing principles that make agent-facing documents behave consistently across runs. ## 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. - Completion criteria and splitting: Guidance on sharpening step boundaries, preventing premature completion, and splitting documents by sequence or invocation. - Use Case: When authoring a new skill, apply the leading-word, pruning, and negation rules to cut token load while making the agent's behavior more predictable. ## Quick Start Ask the agent to review your draft SKILL.md or AGENTS.md using the writing-for-agents principles and suggest concrete edits.