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 cause agents to stop early. This Skill provides a systematic reference 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 front-load trigger words and list distinct branches so agents reach material reliably. - Information hierarchy and progressive disclosure: A framework for deciding what stays inline, what moves behind a pointer, and when to split documents by sequence or invocation. - Completion criteria and pruning: Guidance on writing checkable, exhaustive step boundaries, plus disciplines for removing duplication, no-op instructions, and stale content. - Use Case: When authoring a new skill, use this reference to write a description that triggers on the right prompts, structure the body with clear steps, 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 guidelines and suggest improvements to its description and structure.
