This repository provides best practices for writing professional-grade agent skills, including directory structure conventions (SKILL.md, scripts/, references/, assets/), frontmatter optimization for agent routing, and context window management. It includes the skillgrade tool for evaluating skill quality and preventing regressions using LLMs. The guide focuses on creating discoverable, maintainable, and effective agent capabilities.