creating-skills

name	creating-skills
description	Create Claude skills following best practices: structure, naming, descriptions, progressive disclosure, testing, and converting sources into skills. Use for authoring or improving skills, or encoding a book, guide, codebase, PR history, or visual reference corpus into skills. Triggers: create a skill, SKILL.md, taste.md, convert this book/repo/images to a skill.

Official Documentation

Conversion playbooks (read the matching reference): references/converting-books-to-skills.md (books/guides/docs -> skills) · references/converting-codebases-to-skills.md (OSS repos + PR history -> skills) · references/converting-visual-references-to-skills.md (image/reference corpora -> visual-taste skills) · references/skill-creator.md (Anthropic's bundled guide + init/package scripts). Source map: references/sources.md; parked candidates: references/coverage-gaps.md.

• Skills Overview — How skills work, architecture, structure
• Quickstart — Create your first skill
• Best Practices — Authoring guidelines
• Using Skills with the API — Programmatic usage

Core Principles

1. Concise is Key

The context window is shared. Only add what Claude doesn't already know.

Ask yourself:

• "Does Claude really need this explanation?"
• "Can I assume Claude knows this?"