skills.rest
harlanljones
harlanljonesCOMMUNITY
Explore all skills by this author →
GitHub

hermes-agent-skill-authoring

Author in-repo SKILL.md files with compliant frontmatter and structure.

Updated Dec 7, 2025
Search Tags:#documentation#validation#skill authoring#conventions#frontmatter#skill.md#hermes-agent
One-click install
npx skills add https://github.com/harlanljones/dotfiles --skill hermes-agent-skill-authoring-harlanljones
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-agent-skill-authoring
Source: https://github.com/harlanljones/dotfiles/tree/main/dot_hermes/skills/software-development/hermes-agent-skill-authoring
Command: npx skills add https://github.com/harlanljones/dotfiles --skill hermes-agent-skill-authoring-harlanljones

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Contributing a new skill to the hermes-agent repository requires meeting strict authoring standards for frontmatter, description length, platform gating, tests, and docs; this Skill encodes those rules so contributions pass review on the first attempt. ## Core Features & Use Cases - Frontmatter Standards: Enforces the repo's hardline rules for name, description (60 characters max), author attribution, platforms, and related_skills fields. - Tier and Category Guidance: Helps decide between bundled skills/ and optional-skills/ placement and picking the correct category. - Validation Workflow: Provides a local YAML validation snippet, test requirements, and docs regeneration steps with scope discipline. - Use Case: When asked to add a reusable workflow skill to the hermes-agent repo, follow this Skill to draft the SKILL.md, validate it, add tests, regenerate docs, and open a clean PR. ## Quick Start Ask the agent to create a new in-repo skill for a specific workflow and have it follow the hermes-agent skill authoring standards.

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 add a new skill to the hermes-agent repository?▼

Write the SKILL.md with write_file to skills/<category>/<name>/ or optional-skills/<category>/<name>/, validate the frontmatter locally, add tests under tests/skills/, regenerate docs, then commit and open a PR. Do not use skill_manage(action='create'), which only targets user-local skills.

What are the SKILL.md frontmatter requirements for hermes-agent?▼

Frontmatter must start with --- at byte zero, parse as YAML, and include name, description, version, author, license, platforms, and metadata.hermes tags and related_skills. The description must be 60 characters or fewer, one sentence, and end with a period.

Should a skill go in skills/ or optional-skills/?▼

Bundled skills/ is for daily-driver behavior useful across many user types with a 5+ sessions per month bar. Niche, vertical-specific, or heavy skills belong in optional-skills/. When in doubt, choose optional since promoting later is easier than demoting.

Why does skill_manage create not work for in-repo skills?▼

skill_manage(action='create') writes to the user-local ~/.hermes/skills/ directory, not the repository tree. In-repo skills must be created with write_file and committed with git since they are source, not runtime state.

Why is my new skill not visible in the current session?▼

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

Related Skills

Explore More Software Engineering Skills→
webdevtodayjasonwebdevtodayjason

hermes-agent-skill-authoring

Author and validate structured SKILL.md files against frontmatter and validator constraints.

Community
Intermediate
mathiasbourgoinmathiasbourgoin
2

git-conventions

Standardize git commit messages, branch names, and pull request descriptions.

Community
Intermediate
NousResearchNousResearch
239.1k

hermes-agent-skill-authoring

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

Official
Intermediate
Lucien-1127Lucien-1127

hermes-skill-author

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

Community
Advanced