Repo Health Scan: skill pack for Hermes Agent

Portable SKILL.md that has a coding agent audit any git repository for release readiness and drift

What Repo Health Scan does

The agent discovers the shape of the repository, infers which invariants matter, and reports findings with concrete harm and remediation. It ships no hardcoded checklists, runtime scripts or reference files, and relies on tools already on PATH such as git, shellcheck, python3 and gh. A catalog of candidate dimensions is activated only when repository evidence supports it: history hygiene, shell correctness, version alignment, commit quality, CI efficiency, cross-platform issues, attribution drift, file coverage, external reference health and, on explicit request, reliability and test gaps.

Typical uses are pre-release audits, onboarding to an unfamiliar repository, reviving a dormant one, CI failure triage and review of AI-assisted commits. The payload is one SKILL.md in the agentskills.io format, with no agent-specific commands. The README is explicit that Codex is the only agent with recorded workflow evidence, and that other agents are not supported claims until they have their own compatibility tests.

Key features

Discover, infer, report procedure in one SKILL.md
Activates only the audit dimensions that repository evidence supports
No shipped scripts, checklists or reference files
Optional reliability and test-gap tracing on explicit request
agentskills.io-compatible layout under skills/repo-health-scan

When to use it

Audit a repository before cutting a release
Get oriented in an unfamiliar or dormant repository
Triage a CI failure or review AI-assisted commits

Who it is for: Developers who use terminal-based coding agents and want a repeatable repository health review.

How it fits with Hermes Agent

Tagged hermes-skill and built on the agentskills.io SKILL.md format, but the README records workflow evidence only for Codex and does not claim support for other agents.

How to install Repo Health Scan

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

git clone --filter=blob:none https://github.com/CodeSigils/repo-health-scan

Note: Only Codex has recorded compatibility evidence, and the README does not claim support for other agents, including Hermes.

FAQ

What is Repo Health Scan?

Repo Health Scan is an agent skill that audits any git repository for release readiness, maintenance drift and handoff health. The agent discovers the repository, infers what matters and reports findings with remediation.

Does Repo Health Scan work with Hermes Agent?

It is tagged hermes-skill and uses the portable agentskills.io SKILL.md format. However, the README says Codex is the only agent with recorded workflow evidence and does not claim support for other agents.

How do I install Repo Health Scan?

Clone the repository and make the skill discoverable to your agent. The README documents npx skills add for Codex and Claude Code, and a .agents/skills copy for repository-local Codex use.