skills.rest
Z43L
Z43LCOMMUNITY
Explore all skills by this author →
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
One-click install
npx skills add https://github.com/Z43L/zeus-agent --skill hermes-agent-skill-authoring-z43l
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
DifanaDAPDifanaDAP

hermes-agent-skill-authoring

Guide creation and validation of Hermes-Agent SKILL.md files.

Community
Intermediate
anilcan-karaanilcan-kara

nozich-agent-skill-authoring

Standardize and verify SKILL.md frontmatter for Nozich Skill units.

Community
Intermediate
nicholasgriffintnnicholasgriffintn
2

add-skill

Create and validate SKILL.md files with YAML frontmatter for OpenCode or Claude.

Community
Basic
luiztrilhaluiztrilha

command-development

Create and manage Claude Code slash commands with YAML frontmatter.

Community
Advanced