hermes-agent-skill-authoring

To validate YAML frontmatter for in-repo SKILL.md files, enforce required name and description fields alongside structured body sections. This mechanism guides validators and reviewers to maintain consistent metadata and file layout across the repository.

The required file layout for authoring in-repo SKILL.md entries places files under skills/<category>/<skill-name>/SKILL.md. This structured pattern enforces consistent YAML frontmatter and organizational hierarchy for Hermes Agent skills.

To create a SKILL.md entry under skills/software-development, build a file with proper YAML frontmatter including name and description fields, then follow the structured, multi-section body layout to satisfy validation rules for peer skill consistency.

Yes, the Hermes Agent skill authoring process supports optional hermes metadata in frontmatter. While name and description fields are required for validation, you can include optional hermes metadata alongside the structured body sections.

Validation constraints for SKILL.md description length and structure require a limited description length and a structured, multi-section body. The frontmatter validation rules check for frontmatter presence, specific field requirements, and consistent file layout.