Skill authoring best practices - Claude Platform Docs

The guide outlines best practices for authoring and structuring agent Skills for Claude, emphasizing conciseness, appropriate degrees of freedom, consistent naming conventions, and progressive disclosure patterns. It recommends using minimal SKILL.md files paired with reference documents and utility scripts to manage context windows efficiently. Additionally, the guide details evaluation-driven development and iterative refinement strategies to ensure reliability. Open article →