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 like their peers. ## Core Features & Use Cases - Validator Requirements: Documents the enforced rules from tools/skill_manager_tool.py, including byte-zero frontmatter start, 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 version/author/license/metadata block every in-repo skill carries. - Editing Workflow: Explains when to use write_file versus skill_manage patch/edit actions, how to add references/scripts/assets files, and why new skills only appear in a fresh session. - Use Case: You need to commit a reusable workflow as a skill under skills/software-development/ on the current branch; follow the documented steps to draft, validate locally with a YAML check, and git commit the new SKILL.md. ## Quick Start Ask the agent to create a new in-repo skill under the appropriate skills category following the hermes-agent authoring conventions and validator rules.
