hermes-agent-skill-authoring

To define frontmatter for in-repo skills, you must specify required fields like name and description in your SKILL.md file, using a validator to enforce schema conventions and ensure safe loading by the skills system.

The standard in-repo skill directory structure organizes files under skills/<category>/<skill-name>/, utilizing optional subdirectories for scripts, references, and assets to maintain discoverability and support validation.

You can create a repeatable workflow for patching and auditing in-repo skills by applying a standardized SKILL.md schema and using local validator tooling to guide creation, maintain quality, and ensure peer-aligned structure.

You need a validator to enforce in-repo skill conventions locally because it ensures your SKILL.md frontmatter matches the required schema, enabling safe loading by the skills system and maintaining standardization.

The best way to structure SKILL.md for discoverability is to include required frontmatter fields like name and description, alongside a well-structured body and properly organized supporting files in optional directories.

The skills system requires specific frontmatter fields like name and description to guarantee safe loading, enforce standardization across in-repo skills, and provide a consistent, validated entrypoint for discoverability.