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 skills pass validation and look consistent with existing ones. ## Core Features & Use Cases - Validator Requirements: Documents the enforced rules from tools/skill_manager_tool.py, including frontmatter starting at byte 0, required name and description fields, the 1024-character description limit, and the 100,000-character file cap. - Peer-Matched Structure: Provides the standard section layout (Overview, When to Use, Common Pitfalls, Verification Checklist) and frontmatter shape used by every skill under skills/software-development/. - Workflow Guidance: Covers surveying peer skills, drafting with write_file, local YAML validation, git commit, and editing existing in-repo skills via skill_manage patch or full rewrites. - 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 at skills/<category>/<name>/SKILL.md, validate it locally, and commit it correctly. ## Quick Start Create a new in-repo skill named my-workflow under the software-development category following the hermes-agent authoring conventions.
