nozich-agent-skill-authoring

To validate in-repo SKILL.md frontmatter, apply the skill validator to check required fields like name and description, ensure optional metadata is correct, and verify the Markdown body is non-empty and under size limits.

The correct directory structure for authoring in-repo skills requires placing SKILL.md files under skills/<category>/<name>/, with two allowed sibling directories for supporting content to ensure consistent discovery.

SKILL.md frontmatter requires name and description fields for Nozich Agent skill discovery. Optional metadata includes version, author, and license to standardize validation across the repository.

The best way to standardize SKILL.md files is using validator-driven enforcement via the skill manager tool to check frontmatter field presence, structural correctness, and file size limits for consistent quality control.

In-repo SKILL.md validation fails when required frontmatter fields like name or description are missing, the Markdown body is empty, or the entire file exceeds the specified size limits enforced by the validator.

You can use user-local or in-repo SKILL.md depending on your lifecycle needs. In-repo files under skills/<category>/<name>/ ensure repository-wide discovery and standardized validation, while user-local files serve individual workflows.