codehealth

Run six-dimension LLM reviews and automated web app health checks on codebases.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/vsokh/maestro --skill codehealth-vsokh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codehealth
Source: https://github.com/vsokh/maestro/tree/main/.claude/skills/codehealth
Command: npx skills add https://github.com/vsokh/maestro --skill codehealth-vsokh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codehealth identifies how verifiable a codebase is so that AI agents can safely change code, run validation gates, and know whether their changes are correct. It surfaces gaps in type safety, tests, error handling, security, architecture, and domain logic, and separates an automated health check from the LLM-driven quality assessment. The Skill produces actionable findings and a prioritized backlog so teams and orchestrators can fix agent-readiness problems.

Core Features & Use Cases

  • Six-dimension LLM review: Deep, contextual inspections for Type Safety, Test Quality, Error Handling, Security, Clean Architecture, and Domain Logic using code-aware analysis.
  • Automated web app health check: Run builds, linters, tests/coverage, bundle analysis, dev-server checks, Lighthouse, and dependency audits to capture objective metrics.
  • Modes for workflow fit: Full scan (LLM review + health check + writes), quick health-only check, and diff mode for incremental re-scans.
  • Outputs & integration: Writes latest, history, and backlog artifacts and creates Quality tasks in dev-manager state for the orchestrator to act on.
  • Use case: Run a full audit before enabling autonomous change agents to ensure tests and validation gates will catch regressions.

Quick Start

Invoke the codehealth skill with /codehealth to run a full audit that scores six dimensions, performs a web app health check, and generates a prioritized Quality backlog for dev-manager.

Frequently Asked Questions about codehealth

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

FAQPage Schema
How do I assess code readiness for autonomous AI agents?

Assess code readiness for autonomous AI agents by running a six-dimension LLM review and automated health check to score type safety, tests, error handling, security, architecture, and domain logic. This produces a prioritized backlog of Quality tasks to fix verification gaps before enabling agents.

What is an agent-readiness check and when do I need it for my codebase?

An agent-readiness check measures whether a codebase is verifiable enough for an AI agent to safely change code and run validation gates. You need it before enabling autonomous change agents to ensure tests and validation gates will catch regressions.

How do I run an automated web app health check for code quality?

Run an automated web app health check by executing builds, linters, tests, coverage analysis, bundle analysis, dev-server checks, Lighthouse, and dependency audits. This captures objective metrics and combines them with an LLM-driven quality assessment to produce actionable findings.

Can I run an incremental code quality review on recent changes?

You can run an incremental code quality review on recent changes using diff mode. Diff mode performs an incremental re-scan of the codebase rather than a full audit, allowing you to quickly re-evaluate agent readiness after specific modifications.

Does the codehealth skill integrate with orchestrator workflows?

The codehealth skill integrates with orchestrator workflows by writing latest scores, historical trends, and backlog artifacts. It creates Quality tasks in dev-manager state, allowing the orchestrator to directly act on agent-readiness remediation items.

What are the limitations of LLM-driven code quality reviews?

LLM-driven code quality reviews focus on six contextual dimensions but do not replace objective automated health checks. To get a complete assessment of agent readiness, you must combine the LLM review with automated builds, tests, and dependency audits to capture both subjective and objective metrics.