skill-quality

What problem does it solve?

Skill quality directly impacts how agents select and execute skills. When SKILL.md frontmatter is incomplete or the body lacks clear instructions, agents may misinterpret intent or fail to perform tasks correctly. This guide helps maintainers ensure SKILL.md files are actionable, precise, and consistently structured.

Core Features & Use Cases

• Frontmatter validity: Enforces presence and correctness of name and description fields to ensure reliable skill discovery.
• Instruction clarity: Guides on writing concrete steps, examples, and robust error handling to improve execution.
• Documentation hygiene: Recommends organizing long skills with references/, assets/, and scripts/ for scalable maintenance.
• Use Case: When updating a skill to handle new prompts, apply these guidelines to preserve discoverability and execution accuracy.

Quick Start

Apply the skill-quality guidelines to your SKILL.md to improve clarity, structure, and testability.