hermes-agent-skill-authoring

Author in-repo SKILL.md files with validated frontmatter and peer-matched structure.

Updated May 13, 2026
One-click install
npx skills add https://github.com/superfhp/lumi-agent-body --skill hermes-agent-skill-authoring-superfhp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-agent-skill-authoring
Source: https://github.com/superfhp/lumi-agent-body/tree/main/skills/software-development/hermes-agent-skill-authoring
Command: npx skills add https://github.com/superfhp/lumi-agent-body --skill hermes-agent-skill-authoring-superfhp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating a new skill inside the hermes-agent repository requires matching strict validator rules and peer conventions, and mistakes like leading whitespace, oversized descriptions, or using the wrong creation tool cause validation failures or skills that land in the wrong directory tree. ## Core Features & Use Cases - Validator Rules Reference: Documents the exact frontmatter requirements enforced by tools/skill_manager_tool.py, including the 1024-character description limit and 100,000-character file cap. - Peer-Matched Structure Template: Provides the standard section layout (Overview, When to Use, Common Pitfalls, Verification Checklist) used by every skill under skills/software-development/. - Workflow Guidance: Covers surveying peer skills, drafting with write_file, local YAML validation, and committing to git, plus editing existing in-repo skills via patch or rewrite. - Use Case: When asked to add a reusable workflow skill to the hermes-agent repo on a branch, follow this guide to place the SKILL.md in the correct category directory, validate it locally, and commit it without triggering validator errors. ## 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 SKILL.md file inside the hermes-agent repo?▼

Create in-repo skills with write_file targeting skills/<category>/<name>/SKILL.md, then git add and commit. Do not use skill_manage(action='create'), which writes to the user-local ~/.hermes/skills/ tree instead of the repository.

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

The validator requires the file to start with --- at byte zero, close with a --- line, parse as a YAML mapping, and include name and description fields. The description must be 1024 characters or fewer and the body must be non-empty.

Why does my SKILL.md fail validation in hermes-agent?▼

Common causes are a leading blank line or BOM before the opening ---, a description exceeding 1024 characters, a file over 100,000 characters, or a missing name field. The validator checks content.startswith("---") strictly.

Can skill_manage create skills in the repository tree?▼

No, skill_manage(action='create') only targets the user-local ~/.hermes/skills/ directory. For in-repo skills use write_file, though skill_manage patch and write_file actions do work for editing existing in-repo skills.

Why doesn't my new skill appear in skills_list after creation?▼

The skill loader is initialized at session start and cached, so the current session will not see newly added skills. Verify the skill in a fresh session or via skill_view with the exact path.