What problem does it solve? Writing a SKILL.md that passes Hermes validation and matches peer conventions is error-prone: frontmatter must start at byte zero, descriptions have hard length limits, and in-repo skills cannot be created with the standard skill_manage tool. This Skill encodes the validator rules, size limits, and writing-quality principles so authored skills pass validation and behave predictably. ## Core Features & Use Cases - Frontmatter Validation Rules: Documents the enforced constraints from the skill manager validator, including the 1024-character description limit, 100,000-character file cap, and required name/description fields. - Writing Quality Principles: Provides eight checks for process predictability, completion criteria, duplication pruning, and avoiding no-op prose. - In-Repo Workflow: Covers directory placement under skills/<category>/<name>/, local YAML validation snippets, git commit steps, and common pitfalls like session caching. - Use Case: When asked to add a new reusable workflow skill to the repository, follow this Skill to survey peers, draft the SKILL.md, validate it locally with a Python snippet, and commit it on the active branch. ## Quick Start Ask the agent to create a new in-repo skill under skills/software-development following the authoring and validation workflow.
