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 peers. ## 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: Provides the standard section layout (Overview, When to Use, Common Pitfalls, Verification Checklist) and the version/author/license/metadata block every in-repo skill carries. - Editing Workflow: Explains when to use write_file versus skill_manage patch/edit for creating or updating skills under skills/<category>/<name>/, plus how to add references, templates, and scripts. - Use Case: When asked to add a reusable workflow skill to the hermes-agent repo on a branch, follow this Skill to draft the SKILL.md, validate it locally with a Python snippet, and commit it correctly. ## Quick Start Create a new in-repo skill named my-workflow under the software-development category following the hermes-agent skill authoring conventions.
