What problem does it solve? Creating a new skill inside the hermes-agent repository requires matching strict validator rules and peer conventions; this Skill documents the exact frontmatter requirements, size limits, directory placement, and workflow so new SKILL.md files pass validation and look consistent with existing skills. ## Core Features & Use Cases - Validator Requirements: Documents the enforced rules from tools/skill_manager_tool.py, including frontmatter starting at byte 0, name and description fields, the 1024-character description limit, and the 100,000-character file cap. - Peer-Matched Structure: Defines the expected section layout (Overview, When to Use, Common Pitfalls, Verification Checklist) and the metadata.hermes tags and related_skills block used by every in-repo skill. - Authoring Workflow: Covers surveying peer skills, drafting with write_file, local YAML validation, git commit, and the distinction between in-repo skills and user-local ~/.hermes/skills. - Use Case: When asked to add a reusable workflow skill to the hermes-agent repo on a branch, follow this Skill to place the file under skills/<category>/<name>/SKILL.md, validate it, and commit it correctly. ## Quick Start Create a new in-repo skill named my-workflow under the software-development category with valid frontmatter and commit it to the current branch.
