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 levers that make agent-facing documents behave consistently across runs. ## Core Features & Use Cases - Context pointer design: Write skill descriptions and AGENTS.md lines that front-load trigger words and list distinct branches so agents reach material reliably. - Information hierarchy: Apply progressive disclosure, co-location, and splitting rules to keep documents legible and prevent sprawl. - Completion criteria and pruning: Sharpen step completion conditions, use leading words, and remove duplication, stale caches, and no-op instructions. - Use Case: When authoring a new skill or editing CLAUDE.md, consult this reference to decide invocation mode (model-invoked vs user-invoked), structure the frontmatter description, and prune the body. ## Quick Start Ask the agent to review your draft skill or AGENTS.md file using the writing-for-agents reference and suggest improvements to its description and structure.
