create-skill

Creating a Claude Skill requires writing a SKILL.md file with valid YAML frontmatter in the .claude/skills/<skill-name>/ directory. This enforces a standardized directory layout including optional scripts, references, and assets folders for extended functionality.

The required frontmatter for a SKILL.md file includes valid name and description fields for discovery. This frontmatter validation ensures your Claude Skill unit is properly defined and can be consistently discovered by Claude-based tasks.

Yes, you can include optional directories like scripts, references, and assets when building a Claude Skill. The scaffolding process demonstrates a standardized directory layout that supports these optional folders for extended functionality.

A standardized directory layout for Claude Skills ensures consistency and discoverability across Claude-based tasks. By using a ready-made frontmatter-enabled skeleton, you maintain a defined metadata schema and proper structure for all skill units.

The best way to ensure frontmatter conventions is to use a scaffolding tool that enforces frontmatter validation for name and description fields. This guarantees a properly structured Claude Skill unit with a defined metadata schema and consistent layout.