What problem does it solve? Agent skills often behave inconsistently across runs because their instructions are bloated, duplicated, or poorly triggered. This Skill supplies a shared vocabulary and set of principles for writing and editing skills so the agent follows the same process every run. ## Core Features & Use Cases - Invocation Design: Explains the trade-off between model-invoked skills (description kept, agent-discoverable, context load) and user-invoked skills (description stripped, zero context load, human-triggered). - Information Hierarchy: Defines how to rank content into steps, in-file reference, and disclosed reference behind context pointers, with progressive disclosure and co-location guidance. - Failure Mode Diagnosis: Catalogs failure modes such as premature completion, duplication, sediment, sprawl, no-ops, and negation, each paired with its cure. - Use Case: When editing a skill whose agent keeps rushing steps, consult the failure modes section to sharpen completion criteria or split the sequence to hide post-completion steps. ## Quick Start Ask the agent to review your SKILL.md using the writing-great-skills principles and identify failure modes to fix.
