creating-skills

Creating discoverable Claude Skills requires structured documentation with frontmatter (name and description only), CSO-optimized descriptions focused on triggers, and sections like Overview, When to Use, Quick Reference, and Implementation. This ensures skills appear in search results and are scannable for users.

Optimize skills through CSO (Claude Skill Optimization) by using trigger-focused descriptions, gerund-based naming conventions, and keyword coverage aligned with user search intent. Include concrete examples across development, testing, deployment, and integration contexts to improve findability.

Claude Skills must enforce required structure: frontmatter with name and description (no other fields), gerund-based naming, 1000-character description limits, and defined sections including Overview and When to Use. This standardized approach makes skills actionable and consistent across the platform.

Write skill descriptions by leading with the core task users search for, covering keywords from your domain, and keeping the description under 1000 characters. Focus on what the skill does and when to use it rather than its internal structure.

Yes. Concrete examples across development, testing, deployment, and integration contexts significantly improve discoverability and actionability. Examples help users understand when and how to apply the skill, increasing search relevance and engagement.