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-Accurate Rules: Documents the enforced constraints from tools/skill_manager_tool.py, including the --- frontmatter start, 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 template used by every skill under skills/software-development/. - Correct Tooling Workflow: Explains when to use write_file versus skill_manage(action='create'|'patch'), since create targets ~/.hermes/skills/ rather than the in-repo tree. - Use Case: When asked to add a reusable workflow skill to a branch of the hermes-agent repo, follow this Skill to draft the SKILL.md, validate it locally with a Python snippet, and commit it to the correct category directory. ## Quick Start Ask the agent to create a new in-repo skill under skills/<category>/<name>/ following the hermes-agent-skill-authoring conventions and commit it on the current branch.
