skills.rest
CHENHUI-X
CHENHUI-XCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

hermes-agent-skill-authoring

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

Updated Jul 3, 2026
Search Tags:#documentation#pull request#skill authoring#conventions#frontmatter#skill.md#hermes-agent
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill hermes-agent-skill-authoring-chenhui-x
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-agent-skill-authoring
Source: https://github.com/CHENHUI-X/toolbox/tree/main/official-skills/software-development/hermes-agent-skill-authoring
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill hermes-agent-skill-authoring-chenhui-x

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 walks you through those rules so your PR passes review on the first attempt. ## Core Features & Use Cases - Frontmatter Standards: Enforces the repo hardline rules for name, description (≤60 chars), author attribution, platforms, and related_skills validation. - Tier and Category Guidance: Helps you decide between bundled (skills/) and optional (optional-skills/) placement and pick the right category. - Tests and Docs Workflow: Covers required pytest files, docs regeneration with scope discipline, and sidebar registration. - Use Case: You want to commit a new reusable workflow skill to the hermes-agent repo; this Skill gives you the validation snippet, section ordering, and PR checklist to ship it correctly. ## Quick Start Ask the agent to create a new in-repo skill under skills/<category>/<name>/ following the hermes-agent authoring standards and open a PR.

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 in the hermes-agent repo?▼

Write the file with write_file to skills/<category>/<name>/SKILL.md or optional-skills/<category>/<name>/SKILL.md, then git add and commit. Do not use skill_manage(action='create'), which only targets the user-local ~/.hermes/skills/ tree.

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

The validator requires name and description, but the repo standard also expects version, author, license, platforms, and metadata.hermes with tags and related_skills. The description must be 60 characters or fewer, one sentence, and end with a period.

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

Bundled skills/ is for daily-driver behavior useful across many user types; optional-skills/ is for niche, vertical-specific, or heavy skills. When in doubt, choose optional since promoting later is easier than demoting.

Why doesn't my new skill appear 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.

What tests and docs are required for a repo skill?▼

Add a pytest file at tests/skills/test_<skill>_skill.py using stdlib and unittest.mock only, then run the docs generator and keep the diff scoped to your skill's page, one catalog row, and one sidebar entry.

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
az0512124155azz-sysaz0512124155azz-sys

update-pr

Updates an existing pull request with new commits and refreshed metadata.

Community
Intermediate
ewtoddewtodd

son-of-anton-skill-authoring

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

Community
Intermediate
azmiariffarisazmiariffaris

clawhub-skill-install

Install ClawHub skills into the Hermes skill cache from ZIP packages.

Community
Intermediate