Code Health Scan
Runs a full codebase hygiene scan for dead code, tech debt, outdated dependencies and code smells, then writes a prioritized report.
Dev & CodingIntermediate★ 3,522⑂ 525AI score 7/10Last updated: Sep 22, 2026
What it does
- Finds dead code: unused imports, variables and functions, commented-out blocks, unreachable code.
- Checks dependencies for outdated and vulnerable packages.
- Inventories code smells: long functions, deep nesting, duplication.
- Audits TODO/FIXME comments for linked issue references.
- Writes results to
docs/reviews/code-health-{date}.md, ranked Critical > Warning > Suggestion. - Delegates to the Centinela (QA) agent and hands findings off to the Dev agent for fixes.
Who it's for
- Developers cleaning up debt before a release.
- Teams verifying cleanliness right after a large refactor.
- New joiners who need a fast read on codebase quality.
- Tech leads setting up a recurring hygiene routine.
Examples
- Run
/code-healthbefore tagging a release to collect unresolved TODOs and vulnerable dependencies, then convert them into tickets. - Run it after splitting a large module to catch orphaned functions and files left behind.
- Have a new team member run it in week one and pick their first cleanup task from the report.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/davepoon/buildwithclaude/HEAD/plugins/agent-triforce/skills/code-health/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
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 repo:
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/ - This skill delegates to the Centinela (QA) agent from the agent-triforce plugin — install the whole
plugins/agent-triforcefolder so the agent definitions exist. - Restart Claude Code, then run
/code-healthor ask for a code health scan. - Make sure your project allows writing to
docs/reviews/so the report can be saved.
View source on GitHub ↗License: MIT