health

Score project health across architecture, tests, security, performance, and maintainability.

20|3|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/HerbertJulio/specialist-agent --skill health-herbertjulio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/HerbertJulio/specialist-agent/tree/main/skills/health
Command: npx skills add https://github.com/HerbertJulio/specialist-agent --skill health-herbertjulio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly assess the health of a project or codebase to identify baseline quality, risk, and refactoring needs.

Core Features & Use Cases

  • Holistic Health Scoring across Architecture, Tests, Security, Performance, and Maintainability to produce a single score.
  • Baseline & Onboarding to simplify onboarding onto a new codebase and guide targeted improvements.
  • Use Case: Before a major refactor, run a health assessment to inform scope, identify gaps, and set measurable goals.

Quick Start

Run the health check on the target module to generate a baseline score and actionable recommendations.

Frequently Asked Questions about health

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

FAQPage Schema
How do I assess codebase health before starting a major refactor?

Assess codebase health by scoring architecture, tests, security, performance, and maintainability to produce a single score. This baseline identifies risk and guides refactoring scope and measurable goals.

What metrics are included in a codebase health score?

A codebase health score includes concrete metrics across architecture, tests, security, performance, and maintainability. It checks for ARCHITECTURE.md presence, test signals, security basics, and maintainability indicators.

Can I run a health check on a specific module instead of a whole project?

Yes, you can run a health check on a specific module. The assessment applies to both whole projects and targeted modules to generate a baseline score and actionable recommendations.

How does codebase health scoring simplify onboarding to a new project?

Codebase health scoring simplifies onboarding by providing a baseline quality assessment at a glance. It identifies gaps in security, testing, and architecture, guiding new developers toward targeted improvements.