clean-code-reviewer

Identify and prioritize clean code issues with severity ratings and locations.

278|15|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/hylarucoder/hai-stack --skill clean-code-reviewer-hylarucoder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code-reviewer
Source: https://github.com/hylarucoder/hai-stack/tree/main/skills/clean-code-reviewer
Command: npx skills add https://github.com/hylarucoder/hai-stack --skill clean-code-reviewer-hylarucoder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers identify maintainability issues in existing code by providing focused Clean Code reviews without changing program behavior.

Core Features & Use Cases

  • Code Quality Analysis: Reviews code across naming, function design, duplication, YAGNI, magic numbers, structural clarity, and project conventions.
  • Severity-Rated Findings: Produces prioritized reports with high, medium, and low severity issues, locations, risks, and behavior-preserving refactoring suggestions.
  • Use Case: Before merging a pull request, ask this Skill to inspect changed files and highlight the most valuable clean code improvements.

Quick Start

Ask the clean-code-reviewer skill to review this file for Clean Code issues and provide a prioritized refactoring report.

Frequently Asked Questions about clean-code-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect code smells and maintainability issues in my existing code?

Code review identifies code smells by analyzing naming, function design, duplication, and magic numbers across your files, producing a severity-rated report of maintainability issues with behavior-preserving refactoring suggestions.

How do I perform a clean code review before merging a pull request?

Clean code review before a pull request involves inspecting changed files to highlight severity-rated maintainability issues and providing behavior-preserving refactoring suggestions to improve software quality.

Can I assess refactoring risks in specific functions without altering program behavior?

Refactoring assessments evaluate specific functions to identify maintainability risks and provide behavior-preserving refactoring suggestions, ensuring program behavior remains unaltered while improving structural clarity.

Does this clean code analysis check project conventions across different file types?

Clean code analysis checks project conventions across existing files and functions, applying severity-rated findings and location references to ensure your code adheres to specific project standards.

What is the best way to prioritize code quality issues during a refactor assessment?

Prioritize code quality issues by generating a severity-rated findings report that categorizes clean code smells into high, medium, and low risks based on maintainability impact and structural clarity.

When should I not use automated code smell detection for software quality checks?

Avoid automated code smell detection when altering program behavior is required, as this Skill strictly focuses on behavior-preserving refactor recommendations and maintainability improvements without changing functionality.