Create New Skills

Create Agent Skills by structuring a multi-file project with YAML frontmatter, a SKILL.md containing instructions, and optional REFERENCE.md and EXAMPLES.md files. This approach packages domain-specific capabilities into discoverable, reusable skills across projects and workflows.

Use progressive disclosure with a primary SKILL.md file for core instructions, supplemented by REFERENCE.md for external documentation and EXAMPLES.md for usage patterns. Supporting files in scripts/, templates/, and config/ directories provide controlled tool access and implementation details.

Package as a skill when you've identified a repetitive task or domain where Claude needs consistent expertise across multiple projects or team members. Skills enforce best practices, ensure clear documentation, and enable discovery and reuse at scale.

Yes. The multi-file skill structure with YAML frontmatter and standardized components is designed for shareability. Document your skill's purpose, provide clear examples, and follow the focus and testing best practices to make it discoverable and effective across contexts.

Skills require a YAML frontmatter (name and description), a SKILL.md with instructions, optional REFERENCE.md and EXAMPLES.md files for documentation, and supporting directories (scripts/, templates/, config/) for implementation and tool access control.

Define a focused purpose, write clear descriptions in SKILL.md, provide concrete examples, test thoroughly, and organize supporting files for progressive disclosure. This enforces consistency, makes skills maintainable, and ensures effective agent utilization across workflows.