What problem does it solve? Agent instructions and skill files often accumulate redundant explanations, contradictory rules, and missing operational details, causing agents to miss steps or misinterpret procedures. This Skill provides editorial standards for writing and trimming instructions so a fresh agent with no conversation history can execute them correctly. ## Core Features & Use Cases - Instruction editing standards: Apply rules for single authoritative homes, explicit triggers, completion conditions, and consistent execution flow when writing SKILL.md or AGENTS.md content. - Safe trimming walkthroughs: Validate substantial cuts by walking through normal, ambiguous, and handoff scenarios before accepting a rewrite. - Skill mechanics guidance: Handle invocation policy, description triggers, and reference splitting using the bundled SKILL-MECHANICS.md rules. - Use Case: When asked to shorten a bloated skill file, use this Skill to decide what to keep, what to cut, and how to verify the trimmed version still lets an agent complete the task. ## Quick Start Use the writing-for-agents skill to review and tighten this SKILL.md while preserving its execution flow and completion criteria.