hermes-agent-skill-authoring

To author in-repo skills with validated SKILL.md frontmatter, include required fields like name, description, version, author, license, and platforms alongside a non-empty body to establish a verifiable skill baseline.

The required frontmatter for an in-repo SKILL.md file includes name, description, version, author, license, and platforms. A non-empty body is also mandatory to guarantee a verifiable skill baseline for the Hermes Skill Loader.

Validate a SKILL.md file before committing by running the local validator tool, tools/skill_manager_tool.py. This catches formatting and structural issues, ensuring your in-repo skill meets the repository's frontmatter rules and compliance standards.

In-repo skill authoring supports two placement models: user-local and in-repo. Documenting these models alongside a peer-aligned template simplifies collaboration and ensures consistent structure across skills within the Hermes-Agent repository.

In-repo skills fail to load with invalid frontmatter because the Hermes Skill Loader requires a verifiable skill baseline. Missing required fields like version, author, license, or platforms will cause validation errors during the loading process.

You can use a peer-aligned template to simplify collaboration when authoring in-repo SKILL.md files. However, the structure must still meet the repository's frontmatter rules and pass validation via tools/skill_manager_tool.py to ensure consistency.