Code Health Check

Escáner de salud de código de solo lectura, ejecutado en un sub-agente bifurcado, con un formato de informe fijo graduado por severidad.

Por huangjia2019 · huangjia2019/claude-code-engineering

Probado · Funciona ★ 10.0/10

Code Health Check — Escáner de salud de código de solo lectura, ejecutado en un sub-agente bifurcado, con un formato de informe fijo graduado por severidad.

Qué hace

Escanea un directorio en busca de organización de archivos, manejo de errores, secretos hardcodeados/riesgos de eval/inyección, duplicación e higiene de dependencias, y devuelve un informe markdown calificado (A-F) con hallazgos CRITICAL/WARNING/INFO. Se activa con solicitudes de analizar la calidad del código, encontrar problemas u obtener un informe de salud; se ejecuta en un sub-agente bifurcado aislado, restringido a Read/Grep/Glob, para que no pueda modificar código.

Informe de la prueba

Lo ejecuté contra la app de demostración incluida (una API Express deliberadamente defectuosa distribuida en el mismo repositorio) y detectó los 8 problemas plantados — la inyección SQL, el parser de configuración con eval(), ambos secretos hardcodeados, el error silenciado, e incluso la función muerta formatCategory() — con las severidades CRITICAL/WARNING/INFO correctas y citas de file:line.

Probado el: 2026-07-13 · Claude Code 2.x (agent harness)

Instalación

git clone https://github.com/huangjia2019/claude-code-engineering
cd claude-code-engineering
mkdir -p ~/.claude/skills
cp -r 04-Skills/projects/07-skill-fork-demo/.claude/skills/code-health-check ~/.claude/skills/code-health-check

Comandos y prompts de ejemplo

  • /code-health-checkEscáner de salud de código de solo lectura, ejecutado en un sub-agente bifurcado, con un formato de informe fijo graduado por severidad.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Analyze the code quality of my src directory and give me a health report
  • Find security issues and code smells across this project
  • Give me an overall grade for how healthy this codebase is