What problem does it solve? Documents written for AI 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 levers that make agent-facing documents behave consistently across runs. ## Core Features & Use Cases - Context pointer design: Write descriptions and pointer lines with front-loaded trigger words and one trigger per branch so agents reach material reliably. - Information hierarchy management: Apply progressive disclosure, co-location, and splitting rules to keep documents legible and prevent sprawl. - Completion criteria and pruning: Define clear, demanding done-conditions per step and prune duplication, stale caches, and no-op instructions. - Use Case: When authoring a new skill or editing an AGENTS.md file, consult this reference to decide invocation mode, structure steps versus reference material, and sharpen leading words. ## 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 description and structure.
