Code Health Check

Read-only, sub-agent-forked code health scanner with a fixed severity-graded report format.

Tested · Works

Test report

Verdict
Tested · Works
Score
10.0/10
Tested
Jul 13, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Jul 18, 2026 · 21d8266

Ran it against the bundled demo app (a deliberately buggy Express API shipped in the same repo) and it caught all 8 planted issues - the SQL injection, the eval() config parser, both hardcoded secrets, the swallowed error, and even the dead formatCategory() function - with correct CRITICAL/WARNING/INFO severities and file:line citations.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 5/5
  • Output vs. baseline 10/10
  • Docs & honesty 5/5

What Code Health Check does

Scans a directory for file organization, error handling, hardcoded secrets/eval/injection risks, duplication, and dependency hygiene, then returns a graded (A-F) markdown report with CRITICAL/WARNING/INFO findings. Triggers on requests to analyze code quality, find issues, or get a health report; runs in an isolated forked sub-agent restricted to Read/Grep/Glob so it can't modify code.

How to install Code Health Check

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

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Code Health Check

  • /code-health-check Read-only, sub-agent-forked code health scanner with a fixed severity-graded report format.

It also activates on plain-language prompts like these:

  • 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

Frequently asked questions

Is the Code Health Check skill free?
Yes. The skill itself is free from huangjia2019/claude-code-engineering. SkillProof publishes the install command and an independent test verdict at no cost.
Does Code Health Check work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 13, 2026. Verdict: Tested · Works. Ran it against the bundled demo app (a deliberately buggy Express API shipped in the same repo) and it caught all 8 planted issues - the SQL injection, the eval() config parser, both hardcoded secrets, the swallowed error, and even the dead formatCategory() function - with correct CRITICAL/WARNING/INFO severities and file:line citations.
What is the Code Health Check SkillProof Score?
10.0/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 10/10, docs & honesty 5/5.
How do I install Code Health Check?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Code Health Check with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.