writing-repo-documentation

To extract skill metadata from repository directories, scan each folder for a root SKILL.md file. The tool validates YAML frontmatter, capturing the skill name and description, and records optional scripts, references, and assets components when present.

A valid skill unit requires a self-contained directory rooted at a SKILL.md file. It must contain YAML frontmatter with required name and description fields, while optional scripts, references, and assets components are recorded if they exist in the folder.

Yes, directory scanning requires YAML frontmatter in every SKILL.md file. Specifically, the name and description fields are mandatory for a folder to qualify as a valid skill unit and be included in the extracted metadata.

Yes, you can catalog reusable skills by mapping skill folders into clean metadata. The tool identifies valid skill units, extracts their names and descriptions, and catalogs present components to build a searchable index for review.

If a directory lacks required YAML frontmatter fields like name or description, it fails the validation check. The directory scanner simply skips it, ensuring only properly packaged skill units are mapped into the final metadata output.