A ready-to-use Hermes Agent skill that lets your agent automatically audit, score, and recommend improvements for your entire skill library — no manual configuration needed.
As your agent accumulates skills over time, keeping track of quality, redundancy, and usage becomes impossible manually.
Overall score from 0–100 across Structure, Maintainability, Reusability, and Duplication.
Semantic analysis and cosine similarity clustering finds overlapping skills instantly.
Identifies monolithic packages, reference bloat, and category concentration risks.
Understands skill distribution across categories, asset types, and package complexity.
Tracks which skills are actually used, unused, and high-cost candidates for archival.
Generates actionable suggestions: split, merge, reduce, or remove based on your data.
Clone the awesome-hermes-skills repository and copy the skill into your Hermes Agent skills directory:
git clone https://github.com/johnsonbuilds/awesome-hermes-skills.git
cp -r awesome-hermes-skills/governance/skill-health-check ~/.hermes/profiles/default/skills/
The skill depends on the skill-inspector CLI:
pip install --upgrade git+https://github.com/johnsonbuilds/skill-inspector.git
Simply ask your Hermes Agent in natural language:
"Check the health of my skill library"
"Find duplicate skills in my library"
"Show me unused high-cost skills"
Your agent will run the audit, generate a comprehensive report, and send it to you — ready for action.
Full scan with package analysis, duplicate detection, and governance recommendations.
skill-inspector scan-packages \
--data-dir /opt/data \
--output report.md \
--duplicate-threshold 0.82
Quick health report focusing on structure, maintainability, and duplication scores.
skill-inspector health \
--data-dir /opt/data \
--output health.md
Don't want to install anything manually? Hermes Agent Cloud comes with Skill Inspector pre-installed — just tell your agent to check skill health and it's done.
Skill Health Check is open source and part of the awesome-hermes-skills collection. We welcome contributions, issues, and feature requests.
Skill Health Check is a Hermes Agent skill that enables your agent to automatically audit, score, and recommend improvements for your skill library. It wraps the skill-inspector CLI behind a natural language interface.
Clone the awesome-hermes-skills repo and copy the skill into your Hermes Agent's skills directory. See the GitHub repository for full installation instructions.
Not if you use Hermes Agent Cloud — Skill Inspector is pre-installed and runs automatically. For self-hosted setups, install via pip and run locally.
Yes. Skill Health Check is Apache License 2.0 and available on GitHub.
Get started today — install the skill or try it free on Hermes Agent Cloud.