hermes-agent-skill-authoring

To create a valid SKILL.md file, place it under skills/<category>/<name>/ and include required YAML frontmatter with name and description fields, followed by a non-empty markdown body. This ensures the skill passes the repo validator and is discovered reliably by the Hermes Agent skill loader.

Required YAML frontmatter fields for Hermes Agent skill authoring are name and description. The frontmatter must use correct start and end delimiters, and the description must adhere to specified length limits to pass validation checks.

Committed in-repo skills belong under skills/<category>/<name>/SKILL.md, while user-local skills reside in ~/.hermes/skills. Proper placement ensures the Hermes Agent loader discovers the skill correctly within the repository context.

Recommended peer-matched sections for structuring operational instructions include Overview, When to Use, Common Pitfalls, and Verification Checklist. This consistent structure provides clear guidance and acceptable naming and size conventions for the skill loader.

To safely cross-reference related skills, link preferably to in-repo skills rather than user-local skills. This prevents broken references when other clones interact with the related_skills section of your SKILL.md file.

Your SKILL.md fails repo validator checks due to incorrect frontmatter formatting, missing required name or description fields, exceeding description length limits, or improper frontmatter start and end delimiters. Ensure all YAML frontmatter syntax is correct.