Skip to content
cccskills
FreePublished on GitHub

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.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md1.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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:

SeverityMeaningExample
CRITICALMust fix immediatelyHardcoded secrets, SQL injection
WARNINGShould fix soonMissing error handling, large files
INFONice to improveMinor duplication, naming conventions

Output Format

Return a structured report in this exact format:

# Code Health Report: {directory}

## Overall Score: {A/B/C/D/F}

## Summary
- Files analyzed: {count}
- Issues found: {critical} critical, {warning} warnings, {info} info

## Critical Issues
{list each with file:line and description}

## Warnings
{list each with file:line and description}

## Info
{list each with file:line and description}

## Recommendations
{top 3 actionable recommendations}

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

API design patterns and conventions for this project. Covers RESTful URL naming, response format standards, error handling, and authentication requirements. Use when writing or reviewing API endpoints, designing new APIs, or making decisions about request/response formats.

The English summary is being prepared. Showing the original description.

huangjia2019/claude-code-engineering1.1KUpdated Jul 23, 2026

Generate API documentation from code. Use when the user wants to document APIs, create API reference, generate endpoint documentation, or needs help with OpenAPI/Swagger specs.

The English summary is being prepared. Showing the original description.

huangjia2019/claude-code-engineering1.1KUpdated Jul 23, 2026

Generate API endpoint documentation from Express route files. Use when the user asks to generate, update, or review API docs for Express.js routes.

The English summary is being prepared. Showing the original description.

huangjia2019/claude-code-engineering1.1KUpdated Jul 23, 2026

Generate API endpoint code and documentation from specifications. Use when the user wants to create new API endpoints, generate route handlers, scaffold REST APIs, or produce OpenAPI/Swagger specs from code.

The English summary is being prepared. Showing the original description.

huangjia2019/claude-code-engineering1.1KUpdated Jul 23, 2026

Review code for quality, security, and best practices. Use when the user asks for code review, wants feedback on their code, mentions reviewing changes, or asks about code quality.

The English summary is being prepared. Showing the original description.

huangjia2019/claude-code-engineering1.1KUpdated Jul 23, 2026

Generate an interactive tree visualization of your codebase. Use when exploring a new repo or understanding project structure.

The English summary is being prepared. Showing the original description.

huangjia2019/claude-code-engineering1.1KUpdated Jul 23, 2026

See all skills by huangjia2019

Report a problem with this skill