soul-grader

Grade and validate Hermes Agent SOUL.md files against a research-backed rubric.

57|3|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/cobibean/soul-grader-skill --skill soul-grader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: soul-grader
Source: https://github.com/cobibean/soul-grader-skill/tree/main
Command: npx skills add https://github.com/cobibean/soul-grader-skill --skill soul-grader

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill addresses the challenge of ensuring the integrity and effectiveness of Hermes Agent identity files (SOUL.md), by providing a structured, research-backed framework for grading, reviewing, and rewriting these files.

Core Features & Use Cases

  • Grading & Reviewing: Automates the grading of SOUL.md files using a predefined rubric, offering both a score and actionable feedback.
  • Rewriting & Improving: Recommends changes to improve the quality of SOUL.md files based on the grading results.
  • Automated Validation: Ensures that SOUL.md files adhere to the required standards, flagging issues like the presence of secrets or false claims.
  • Use Case: When you need to ensure that a new Hermes Agent has a well-defined identity and role, use this Skill to grade the associated SOUL.md file.

Quick Start

Use the soul-grader skill to grade agents/my-agent/SOUL.md.

Frequently Asked Questions about soul-grader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a Hermes Agent SOUL.md file for identity and role compliance?

To validate a Hermes Agent SOUL.md file, you grade it against a research-backed rubric to ensure compliance with identity and role standards. This automated validation flags issues like false claims or embedded secrets during agent onboarding.

What is the best way to review and improve a poorly defined agent identity file?

The best way to improve a poorly defined agent identity file is to grade it using a structured rubric. This process generates a score and actionable feedback, recommending specific changes to refine the SOUL.md file for better role clarification.

When do I need to use a grading rubric for agent onboarding?

You need to use a grading rubric for agent onboarding when ensuring a new Hermes Agent has a well-defined identity. It validates the associated SOUL.md file against research-backed standards before deployment.

Does the SOUL.md grading process require external dependencies or reference files?

The SOUL.md grading process requires access to the SOUL.md file itself and the research references provided within the skill. It operates without external dependencies, using internal scripts and assets to evaluate compliance.

Why does my Hermes Agent SOUL.md fail identity validation checks?

A Hermes Agent SOUL.md fails identity validation checks when it contains false claims, embedded secrets, or lacks adherence to required research-backed identity standards. The grading rubric identifies these specific compliance issues.