skill-one

A SKILL.md frontmatter is a metadata block that exposes a skill's name and description to enable discovery and indexing by tooling that validates Skill Unit structures.

To create a minimal Skill Unit, establish a SKILL.md frontmatter containing a name and description, then optionally populate resource directories with scripts, references, or assets for runtime use.

A valid Skill Unit does not require scripts and assets directories; it only mandates a frontmatter with name and description, while resource directories are optional and can be populated as needed.

The best way to structure repository metadata for skill indexing is using a self-contained SKILL.md frontmatter that defines the name and description, allowing tooling to extract metadata and validate the structure.

Yes, you can use a sample Skill Unit to test metadata extraction and frontmatter validation tooling because it serves as a reference demonstrating the required discovery structure and body loading.

Skill discovery tooling fails to index a repository without frontmatter because a valid Skill Unit requires a SKILL.md file exposing a name and description to satisfy functional indexing requirements.