SOUL.md Grader Skill: skill pack for Hermes Agent

Hermes Agent skill that grades, reviews and rewrites SOUL.md identity files with a 100-point rubric

What SOUL.md Grader Skill does

SOUL.md is the identity layer of a Hermes Agent profile: who the agent is, who it serves, what it owns, how it makes tradeoffs and what character it brings. This skill grades that file only, assuming the operating agreement lives in AGENTS.md or CLAUDE.md, and it rewards a clean split between the two. The skill tells the agent to load references/soul-md-grading-standard.md first, then to use the bundled field guide and wording layer for detail and examples.

The rubric scores a SOUL.md out of 100 across eleven areas, including mission clarity, identity and role boundaries, core thesis, optimization hierarchy, judgment and decision ownership, voice and truthfulness posture, success orientation, artifact separation and runtime hygiene. System-level blockers include missing verified safety controls, false live-state claims, cross-client contamination and wrong Hermes frontmatter assumptions. Typical requests are to grade a file and say whether it is deployable, compare two drafts, or rewrite a weak file without inventing access, credentials, live services or authority.

Key features

100-point rubric across eleven areas of a SOUL.md
System-level blockers such as false live-state claims and wrong frontmatter assumptions
Grading, comparison of two drafts, and rewrite modes
Bundled grading standard, field guide and wording layer under references/
Install paths for the default Hermes profile and named profiles

When to use it

Checking whether an agent's SOUL.md is ready to deploy
Choosing between two SOUL.md drafts
Rewriting a vague identity file into a production-ready one without inventing authority

Who it is for: Hermes Agent users who write SOUL.md files for their profiles and want a structured review.

How it fits with Hermes Agent

Built for Hermes Agent: it grades Hermes SOUL.md files, checks Hermes loading and frontmatter assumptions, and installs into a Hermes profile's skills directory.

How to install SOUL.md Grader Skill

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

mkdir -p ~/.hermes/skills/community
git clone https://github.com/cobibean/soul-grader-skill.git \
 ~/.hermes/skills/community/soul-grader

Note: The README states this is an unofficial community skill, not an official Nous Research or Hermes Agent release.

FAQ

What is SOUL.md Grader Skill?

SOUL.md Grader Skill is a Hermes Agent skill that scores SOUL.md identity files out of 100 with a documented rubric. It can also compare drafts and rewrite weak files.

Does SOUL.md Grader Skill work with Hermes Agent?

Yes, it is made for Hermes Agent and for the way Hermes loads SOUL.md. The README also shows copying it into Codex or Claude skill directories.

How do I install SOUL.md Grader Skill?

Clone the repository into ~/.hermes/skills/community/soul-grader, or into the skills directory of a named profile. Then start a fresh Hermes session or run /reload-skills.