Code Health Scan
One command that scans your codebase for dead code, tech debt, vulnerable dependencies and code smells, then writes a dated report.
Security & ReviewBeginner★ 3,276⑂ 452AI score 6/10Last updated: Aug 7, 2026
What it does
Running /code-health delegates a full hygiene sweep to the Centinela (QA) agent:
- Dead code detection: unused imports, variables and functions, commented-out blocks, unreachable code
- Dependency check for outdated packages and known vulnerabilities
- Code smell inventory: overly long functions, deep nesting, duplication
- TODO/FIXME audit to confirm each one links to an issue
- Findings saved to
docs/reviews/code-health-{date}.md, prioritized Critical > Warning > Suggestion - Comparison against previous scans to track recurring issues, with verification to reduce false positives from dynamic imports or plugins
Who it's for
- Developers cleaning up before a release
- Teams verifying cleanliness after a large refactor
- New joiners who need a quick read on current code quality
- Tech leads setting up a recurring hygiene routine
Examples
- Pre-release gate — run
/code-health, pull out vulnerable dependencies and unresolved TODOs marked Critical, and attach the report to your release checklist. - Post-refactor cleanup — get a verified list of now-unused functions and stale commented-out code and delete them in one pass.
- Monthly debt tracking — run it each month, diff against the prior report, and file recurring code smells into the team backlog.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the plugins/agent-triforce/skills/code-health folder from the GitHub repo davepoon/buildwithclaude into my ~/.claude/skills/code-health/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/davepoon/buildwithclaude.git && mkdir -p ~/.claude/skills && cp -r buildwithclaude/plugins/agent-triforce/skills/code-health ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repository:
git clone https://github.com/davepoon/buildwithclaude.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r buildwithclaude/plugins/agent-triforce/skills/code-health ~/.claude/skills/ - Because the skill delegates to the Centinela (QA) agent, also copy the agent definitions from
buildwithclaude/plugins/agent-triforceinto the matching location (e.g.~/.claude/agents/). - Restart Claude Code, open your project folder, and run
/code-healthto test it. - When it finishes, open the generated report under
docs/reviews/.
View source on GitHub ↗License: MIT