hermes-agent-skill-authoring

Enforce SKILL.md formatting and YAML frontmatter for Hermes Agent skills.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill hermes-agent-skill-authoring-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-agent-skill-authoring
Source: https://github.com/MarbleSodas/Mavis/tree/main/skills/software-development/hermes-agent-skill-authoring
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill hermes-agent-skill-authoring-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you correctly author, validate, and structure Hermes Agent skills by documenting required SKILL.md frontmatter rules and the expected layout for software-development skills.

Core Features & Use Cases

  • Validates SKILL.md frontmatter: Ensures the YAML block includes required fields like name and description, with strict formatting and size limits.
  • Standardizes peer structure: Guides you to follow the common software-development skill organization so skills are consistent and discoverable.
  • Avoids common workflow mistakes: Covers correct repo placement and clarifies differences between user-local skill creation and in-repo committed skills.

Quick Start

Author the in-repo skill by creating skills/software-development/<category>/<skill-name>/SKILL.md with the required YAML frontmatter and a body that includes an Overview, When to Use, Common Pitfalls, and Verification Checklist.

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 format SKILL.md frontmatter for an in-repo Hermes Agent skill?

To format SKILL.md frontmatter for a Hermes Agent skill, use a correctly delimited YAML mapping block containing required fields like name and description, followed by a non-empty operational body adhering to strict size limits.

What is the correct repository placement for committed Hermes Agent skills?

Correct repository placement requires creating your SKILL.md file under the skills/software-development/<category>/<skill-name>/ directory to ensure committed Hermes Agent skills are properly structured and discoverable by the skill manager tool.

What sections do I need to include in the SKILL.md operational body?

The SKILL.md operational body must include an Overview, When to Use, Common Pitfalls, and Verification Checklist to standardize peer structure and ensure the skill is validated by the skill manager tool.

How does in-repo skill authoring differ from user-local skill creation?

In-repo skill authoring involves committing validated SKILL.md files within the repository directory structure to ship with the package, whereas user-local skill creation does not require adherence to these peer structure and repository placement conventions.

Why does my Hermes Agent skill fail skill manager validation?

Hermes Agent skill validation fails when the SKILL.md file is missing required YAML frontmatter fields, exceeds size constraints, contains an empty operational body, or violates the expected repository directory placement.