What problem does it solve? Writing a SKILL.md that passes the hermes-agent validator and matches peer conventions is error-prone: frontmatter must start at byte zero, descriptions have a 1024-character limit, and optional fields like version, author, license, and platforms are expected by every peer skill even though the validator does not enforce them. ## Core Features & Use Cases - Frontmatter and structure rules: Documents the exact validator requirements from tools/skill_manager_tool.py, including name length limits, description format, and the 100,000-character file cap. - Bundled validation script: Runs 17 checks covering required fields, peer-matched optional fields, section structure, and in-repo related_skills resolution. - Ecosystem reference guide: Compares skill conventions across my-supremepowers, Cline, and hermes-agent for porting skills between platforms. - Use Case: When asked to add a new reusable workflow skill to the hermes-agent repository, follow the workflow to survey peers, draft the SKILL.md, validate it with scripts/validate-skill.py, and commit it on the active branch. ## Quick Start Create a new in-repo skill for the hermes-agent repository under skills/software-development and validate it with the bundled script.
