skills.rest
AtlasOmnia
AtlasOmniaCOMMUNITY
Explore all skills by this author →
Website𝕏@AtlasOmniaGitHub

hermes-agent-skill-authoring

Author and validate in-repo SKILL.md files for Hermes Agent skills.

115|9|Updated Aug 5, 2026
Search Tags:#documentation#skill authoring#conventions#frontmatter#skill.md#yaml validation#hermes agent
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill hermes-agent-skill-authoring-atlasomnia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-agent-skill-authoring
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/software-development/hermes-agent-skill-authoring
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill hermes-agent-skill-authoring-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml.

What problem does it solve? Creating a new skill inside the Hermes Agent repository requires matching strict frontmatter validation rules and peer conventions, and mistakes like wrong placement or malformed YAML cause silent validation failures. ## Core Features & Use Cases - Frontmatter Validation Rules: Documents the exact validator requirements from tools/skill_manager_tool.py, including the 1024-character description limit and 100,000-character file cap. - Peer-Matched Structure: Provides the standard section layout (Overview, When to Use, Common Pitfalls, Verification Checklist) used by every skill under skills/software-development/. - Workflow Guidance: Covers directory placement, category selection, local YAML validation, git commit, and directory index regeneration. - Use Case: When asked to add a reusable workflow skill to a Hermes Agent branch, follow this guide to draft the SKILL.md, validate it with a Python snippet, and commit it correctly. ## Quick Start Ask the agent to create a new in-repo skill under skills/<category>/<name>/ following the hermes-agent-skill-authoring conventions and validate the frontmatter before committing.

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 create a new skill in the Hermes Agent repository?▼

Create the file at skills/<category>/<name>/SKILL.md using write_file, not skill_manage(action='create'), which only targets the user-local ~/.hermes/skills tree. Then validate the frontmatter locally, git add, and commit on the active branch.

What frontmatter fields are required in a SKILL.md file?▼

The validator requires the file to start with --- at byte zero, parse as a YAML mapping, and include name and description fields with a non-empty body. Version, author, license, and metadata are not enforced but match every peer skill.

What is the maximum description length for a Hermes skill?▼

The description field is limited to 1024 characters, enforced as MAX_DESCRIPTION_LENGTH by the validator. The full SKILL.md file is capped at 100,000 characters, with peer skills typically ranging from 8,000 to 14,000 characters.

Why doesn't my new skill appear in the current Hermes session?▼

The skill loader is initialized at session start and cached, so skill_view and skills_list will not see newly created skills until a fresh session. This is expected behavior, not a bug.

Can an in-repo skill reference user-local skills in related_skills?▼

Yes, the related_skills metadata unions both trees at load time, but the reference breaks for other users who clone the repo fresh. Prefer referencing only in-repo skills, or promote frequently referenced user-local skills into the repository.

Related Skills

Explore More Software Engineering Skills→
wubing7755wubing7755

ada-hermes-agent-skill-authoring

Author and validate SKILL.md files with frontmatter rules and quality checks.

Community
Intermediate
giovannimnzgiovannimnz

gsd-index

Index GSD Hermes skills with names and descriptions via skill_view.

Community
Basic
azmiariffarisazmiariffaris

requesting-code-review

Automate pre-commit verification with static security scans and quality gates.

Community
Advanced
Lucien-1127Lucien-1127

hermes-skill-author

Author Hermes SKILL.md files with quality scoring and validation gates.

Community
Advanced