creating-skills

A SKILL.md file requires frontmatter with at minimum the name and description fields to define the skill, and can optionally include scripts, references, and assets directories to support deterministic tasks and provide on-demand context.

The Claude Code skills directory structure centers on a SKILL.md file with enforced frontmatter, supplemented by optional folders for scripts, references, and assets that organize resources for deterministic task execution and progressive disclosure.

Documenting best practices for Claude Code skill creation involves using a standardized SKILL.md template with consistent frontmatter, clear directory scaffolding, and organized optional resources to accelerate onboarding and maintain project quality.

The 3-level loading structure enables progressive disclosure in Claude Code skills by layering context delivery, starting with core SKILL.md frontmatter and expanding into optional scripts, references, and assets only when on-demand context is required.

Yes, you can update existing Claude Code skills by applying a standardized SKILL.md template that enforces required frontmatter conventions and reorganizes optional resources like scripts, references, and assets into the proper directory scaffolding.

No, optional scripts, references, and assets are not required in a Claude Code skill directory; they are added only when needed to support deterministic tasks or provide supplementary on-demand context alongside the required SKILL.md file.