What problem does it solve? Creating a new skill inside the hermes-agent repository requires matching strict validator rules and peer conventions, and mistakes like leading whitespace, oversized descriptions, or using the wrong creation tool cause validation failures or skills that land in the wrong directory tree. ## Core Features & Use Cases - Validator Rules Reference: Documents the exact frontmatter requirements enforced by tools/skill_manager_tool.py, including the 1024-character description limit and 100,000-character file cap. - Peer-Matched Structure Template: Provides the standard section layout (Overview, When to Use, Common Pitfalls, Verification Checklist) used by every skill under skills/software-development/. - Workflow Guidance: Covers surveying peer skills, drafting with write_file, local YAML validation, and committing to git, plus editing existing in-repo skills via patch or rewrite. - Use Case: When asked to add a reusable workflow skill to the hermes-agent repo on a branch, follow this guide to place the SKILL.md in the correct category directory, validate it locally, and commit it without triggering validator errors. ## Quick Start Ask the agent to create a new in-repo skill under skills/<category>/<name>/ following the hermes-agent-skill-authoring conventions and validate the frontmatter before committing.