skill-design-guide

What problem does it solve?

This guide standardizes the creation, review, and upkeep of Claude Skills by codifying official specifications, YAML frontmatter rules, and description-writing best practices to reduce ambiguity and risk.

Core Features & Use Cases

• Provides official frontmatter specifications (name, description, compatibility, license, metadata) and naming and structuring guidelines.
• Promotes Progressive Disclosure architecture to balance detail with token efficiency.
• Offers best-practice guidance for writing clear descriptions, troubleshooting, and safety considerations for skill authors and reviewers.

Quick Start

Create a new skill directory named skill-name, add SKILL.md with the required frontmatter, and consult the references for deeper guidance on design patterns and pitfalls.