What problem does it solve? Writing skills for AI agents often produces bloated, unreliable instructions that fire inconsistently or steer the agent unpredictably. This Skill supplies a shared vocabulary and decision framework for structuring, invoking, and pruning skills so the agent behaves the same way on every run. ## Core Features & Use Cases - Invocation Design: Decide between model-invoked and user-invoked skills by weighing context load against cognitive load, and write trigger-rich descriptions. - Information Hierarchy: Organize content into steps, in-file reference, and disclosed reference behind context pointers, using progressive disclosure and co-location. - Failure-Mode Diagnosis: Identify and fix premature completion, duplication, sediment, sprawl, no-ops, and negation in existing skills. - Use Case: When editing a skill whose agent keeps rushing steps, consult the failure modes section to sharpen completion criteria or split the sequence before rewriting. ## Quick Start Ask the agent to review your SKILL.md using the writing-great-skills principles and suggest improvements to its description and structure.
