your-skill-name

To standardize plugin skill metadata for marketplace discovery, create a root SKILL.md file with YAML frontmatter defining the skill's name and description, ensuring consistent activation and discoverability across the plugin marketplace.

A Skill Unit is a self-contained, standardized plugin component that works in a marketplace by using a root SKILL.md file for discovery and activation, while optionally housing scripts, references, and assets in dedicated directories.

To create a new skill template with documentation and assets, copy the template directory, customize the root SKILL.md frontmatter, and add optional code, reference material, or media to the scripts/, references/, and assets/ folders.

A valid Skill Unit does not require scripts and assets directories; it only mandates a root SKILL.md file containing the required name and description frontmatter, while directories for scripts, references, and assets remain entirely optional.

The best way to structure plugin development workflows for new skills is to enforce a root SKILL.md with required frontmatter for standardized metadata, allowing teams to consistently implement and activate self-contained skill units.