Verified:GitHub

hermes-agent-skill-authoring

Create and edit in-repo Hermes-agent skills with valid SKILL.md structure.

Updated May 5, 2026

Search Tags:#documentation #validation #yaml-frontmatter #skill-authoring #skill-manager #hermes-agent #in-repo-guidelines

Ready to run

npx skills add https://github.com/Z43L/zeus-agent --skill hermes-agent-skill-authoring-z43l

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: hermes-agent-skill-authoring
Source: https://github.com/Z43L/zeus-agent/tree/main/skills/software-development/hermes-agent-skill-authoring
Command: npx skills add https://github.com/Z43L/zeus-agent --skill hermes-agent-skill-authoring-z43l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken or non-discoverable Hermes skills by specifying the exact SKILL.md structure, validator constraints, and expected in-repo folder conventions.

Core Features & Use Cases

Correct in-repo authoring workflow: explains the difference between user-local skills and committed in-repo skills, and how to edit vs rewrite.
Validator-first requirements: documents frontmatter formatting rules, required fields (name/description), size limits, and expected shape for peer-matched skills.
Quality and maintainability guidance: provides recommended sections, common pitfalls, and a verification checklist to ensure consistency across the skills/ tree.

Quick Start

Use this guidance to create or rewrite a new skill at skills/software-development/<category>/<name>/SKILL.md with valid YAML frontmatter and a complete operational body, then verify the file matches the listed constraints.

Frequently Asked Questions about hermes-agent-skill-authoring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I structure YAML frontmatter for Hermes agent skills?▼

To structure YAML frontmatter for Hermes skills, include mandatory name and description fields that satisfy length limits and total file-size constraints, ensuring a non-empty instructional body within the SKILL.md file.

What is the correct folder placement for in-repo skills?▼

In-repo skills require correct placement under the skills/software-development/ directory. You must create or edit the SKILL.md file at skills/software-development/<category>/<name>/ to ensure proper discovery and pass the repository validator constraints.

Why does my SKILL.md fail the repository validator?▼

Your SKILL.md fails validation due to missing name or description fields in the YAML frontmatter, exceeding file-size limits, or having an empty instructional body. Ensure all required fields are present and meet the peer-matched structure constraints.

How do I validate Hermes skill files before shipping?▼

To validate Hermes skill files before shipping, check YAML frontmatter for required name and description fields, verify description length and total file-size constraints are met, and confirm the instructional body is non-empty using the provided verification checklist.

What are the size limits for SKILL.md files in the Hermes agent?▼

The Hermes agent enforces total file-size constraints on SKILL.md files to maintain consistency across the skills tree. Files must contain valid YAML frontmatter and a complete operational body while staying within these specified size limitations.