What problem does it solve? Documents written for agents often fail unpredictably: weak descriptions never trigger, bloated files dilute attention, and vague steps end early. This Skill provides a reference of writing levers that make agent-consumed 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, with one trigger per branch and front-loaded leading words. - Information hierarchy: A ladder for placing content as in-file steps, in-file reference, or disclosed reference behind pointers, with progressive disclosure and co-location guidance. - Completion criteria and splitting: Techniques for sharpening step completion conditions, deciding when to split documents by sequence or invocation, and configuring model-invoked versus user-invoked skills. - Use Case: When creating a new skill whose description never fires, apply the pointer-writing rules to front-load trigger branches and prune synonyms so the agent discovers it reliably. ## Quick Start Ask the agent to review your draft SKILL.md or AGENTS.md using the writing-for-agents reference and suggest concrete edits.
