What problem does it solve? Writing a SKILL.md that passes validation and matches peer conventions is error-prone: frontmatter must start at byte zero, descriptions are truncated at 57 characters in the system prompt index, and the wrong creation tool writes to the wrong directory. This Skill encodes the exact validator rules, size limits, and peer-matched structure so new in-repo skills are accepted and consistent on the first commit. ## Core Features & Use Cases - Validator-Accurate Rules: Documents the hard requirements from the skill manager validator, including frontmatter format, 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) plus a copyable frontmatter template with version, author, license, and metadata fields. - Workflow Guidance: Covers surveying peer skills, drafting with write_file, local YAML validation, editing existing skills, and committing to the correct branch. - Use Case: When asked to add a reusable workflow skill to the repository, follow this Skill to place the file under skills/<category>/<name>/, write compliant frontmatter, validate it locally, and commit it. ## Quick Start Create a new in-repo skill for the software-development category following the hermes-agent-skill-authoring conventions and validate its frontmatter before committing.
