hermes-agent-skill-authoring

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.

The validator requires name and description, but repo standards also expect 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.

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.

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.

Add a pytest file at tests/skills/test_<skill>_skill.py using stdlib and unittest.mock only, then run the docs generator and revert unrelated drift. The final diff should show only your SKILL.md, one docs page, a catalog row, and one sidebar entry.