Skip to main content
ClaudeWave
Skill3k repo starsupdated yesterday

code-health

The code-health skill runs a comprehensive scan of a codebase to identify dead code, outdated dependencies, code smells, and unresolved technical debt, then generates a detailed report with prioritized findings. Use it before releases, after major refactoring, during periodic maintenance checks, or when assessing code quality for onboarding purposes.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/davepoon/buildwithclaude /tmp/code-health && cp -r /tmp/code-health/plugins/agent-triforce/skills/code-health ~/.claude/skills/code-health
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Code Health

Runs a comprehensive code health scan using the Centinela (QA) agent.

## When to Use This Skill

- Periodic codebase hygiene check
- Before a release to ensure no dead code or unresolved debt
- After a large refactoring to verify cleanliness
- When onboarding to understand current code quality

## What This Skill Does

1. Runs the SIGN IN checklist
2. Scans for dead code (unused imports, variables, functions, commented-out blocks, unreachable code)
3. Checks for outdated and vulnerable dependencies
4. Detects code smells (long functions, deep nesting, duplication)
5. Audits TODO/FIXME comments for issue references
6. Runs the Scan Complete checklist (TIME OUT)
7. Writes findings to `docs/reviews/code-health-{date}.md`
8. Prepares findings handoff to Dev agent

## How to Use

### Basic Usage

```
/code-health
```

## Example

**User**: `/code-health`

**Output**: A code health report at `docs/reviews/code-health-2026-02-23.md` with:
- Dead code findings (verified, not false positives)
- Dependency status and vulnerabilities
- Code smell inventory
- TODO/FIXME audit
- Prioritized findings: Critical > Warning > Suggestion

## Tips

- Scans all source directories, not just `src/` — includes `tests/` and config files
- Previous scan findings are compared to track recurring issues
- Findings are verified to avoid false positives from dynamic imports or plugins