Codebase Review Skill

This repository contains the goal documents for a local Hermes skill that supports explicit codebase health reviews, plus an installable skill package.

The current implementation provides a focused manual review workflow, report/finding output guidance, and a setup workflow for preparing repositories with durable review documentation, normalized local review commands, and concise setup verification classifications.

Install locally

From a clone of this repository:

mkdir -p ~/.hermes/skills
ln -sfn "$(pwd)/skills/codebase-review" ~/.hermes/skills/codebase-review

Then start a fresh Hermes session and load the skill:

hermes --skills codebase-review

Or from an existing session after restarting/reloading skills:

/skill codebase-review

You can verify that Hermes sees the package with:

hermes skills list | grep codebase-review

Skill package

• Codebase review skill

Goal docs

• Goal overview
• Product requirements
• Design decisions
• Open questions