hermes-agent-skill-authoring

Validate in-repo SKILL.md files by placing them under skills/<category>/<name>/SKILL.md with required frontmatter fields including name, description, version, author, license, and metadata. The skill manager tool enforces these rules during discovery.

Required frontmatter fields for in-repo skills are name, description, version, author, license, and metadata. The validation process verifies these fields exist, ensures body content is non-empty, and checks that size limits are respected.

The recommended in-repo SKILL.md structure includes Overview, When to Use, Pitfalls, and Verification sections. This predictable format ensures reliable skill discovery and onboarding through consistent documentation.

In-repo skill files must be placed at skills/<category>/<name>/SKILL.md for the skill manager tool to discover them. This directory convention ensures reliable discovery and validated reuse across repositories.

If SKILL.md body content is empty or exceeds size limits, validation fails. The skill manager enforces non-empty body content and size limit compliance before allowing skill discovery and reuse.

You can extend or patch existing in-repo skills through a guided workflow with validated templates. The authoring process supports creating, patching, and extending skill definitions while maintaining frontmatter validation and standardized structure.