Claude MarketplacesSubmit
huangjia2019 avatar

Code Health Check

huangjia2019/claude-code-engineering

This runs a systematic health check on your codebase, scanning for hardcoded secrets, missing error handling, oversized files, code duplication, and other common issues. It categorizes findings as critical, warning, or info, then gives you a graded report with file and line numbers. Think of it as a structured second pair of eyes before a code review or when inheriting a project. The checks are practical rather than exhaustive: it won't replace a linter, but it catches the kind of stuff that causes production fires. Most useful when you need a quick audit of unfamiliar code or want to spot low-hanging fruit in your own work.

GitHub stars
826
last updated
May 30, 2026
View on GitHub

Install

$ npx -y skills add huangjia2019/claude-code-engineering --skill code-health-check --agent claude-code

Installs into .claude/skills of the current project.

Files

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:

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/huangjia2019/claude-code-engineering
Category
Code Review & Quality
First seen
Jun 11, 2026

More from huangjia2019/claude-code-engineering

All 11

Recommended

More Code Review & Quality
1kubesphere avataropenpitrixkubesphere/kubesphereKubeSphere OpenPitrix application management Skill. Use when users ask about KubeSphere App Store, OpenPitrix, Helm/YAML application templates, application repo0skills.sh installs
2malob avatarmcp-buildermalob/nix-configGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when b0skills.sh installs
3mc-zuri avatarskill-buildermc-zuri/mineflayer-bedrockCreate new Claude Code skills with proper SKILL.md format, frontmatter, and best practices. Use when building, scaffolding, or generating a new skill for Claude0skills.sh installs
4meain avatarcommitmeain/dotfilesCreate git commits for dotfiles changes, grouping by component with conventional prefix style0skills.sh installs
5metabase avatartypescript-writemetabase/metabaseWrite TypeScript and JavaScript code following Metabase coding standards and best practices. Use when developing or refactoring TypeScript/JavaScript code.0skills.sh installs
6n8n-io avatarcreate-prn8n-io/n8nCreates GitHub pull requests with properly formatted titles that pass the check-pr-title CI validation. Use when creating PRs, submitting changes for review, or0skills.sh installs