code-health-check
Perform a comprehensive code health check on a directory. Use when the user asks to analyze code quality, find issues, or get a health report.
npx skills add huangjia2019/claude-code-engineering --skill code-health-check --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Code Health Check Analyze the codebase at `$ARGUMENTS` and produce a structured health report. ## Checks to Perform ### 1. File Organization - Are files reasonably sized? (Flag files > 200 lines) - Is the directory structure logical? - Any files that look misplaced? ### 2. Error Handling - Are async operations wrapped in try/catch? - Are errors propagated correctly (not swallowed)? - Is there a global error handler? ### 3. Security Basics - Any hardcoded secrets, API keys, or passwords? - Any use of `eval()` or similar dangerous functions? - Are user inputs validated before use? ### 4. Code Quality - Any obvious code duplication (similar blocks in multiple files)? - Any unused variables or imports? - Are function signatures reasonable (not too many parameters)? ### 5. Dependency Hygiene - Are all imported modules actually used? - Any circular dependencies? ## Severity Levels Use these to categorize issues: | Severity | Meaning | Example | |----------|---------|---------| | CRITICAL | Must fix immediately | Hardcoded secrets, SQL injection | | WARNING | Should fix soon | Missing error handling, large files | | INFO | Nice to improve | Minor duplication, naming conventions | ## Out
- Checks to Perform
- 1. File Organization
- 2. Error Handling
- 3. Security Basics
- 4. Code Quality
- 5. Dependency Hygiene
- Severity Levels
- Output Format
What does the code-health-check skill do?
Perform a comprehensive code health check on a directory. Use when the user asks to analyze code quality, find issues, or get a health report.
How do I install it?
Run `npx skills add huangjia2019/claude-code-engineering --skill code-health-check --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From huangjia2019/claude-code-engineering, a repository with 1,040 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.