clean-code-review

Audit codebases for violations of Uncle Bob's Clean Code principles.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/ddsyasas/pomodoro-app-shared --skill clean-code-review-ddsyasas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code-review
Source: https://github.com/ddsyasas/pomodoro-app-shared/tree/main/pomodoro-app/.claude/skills/clean-code-review
Command: npx skills add https://github.com/ddsyasas/pomodoro-app-shared --skill clean-code-review-ddsyasas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Comprehensive code review against all Clean Code principles from Uncle Bob's teachings. Activates after completing implementation tasks, before marking work as done, before committing code, or when the user mentions review, quality check, clean code review, code quality, or wants to verify code meets standards.

Core Features & Use Cases

  • Naming Check: Evaluates whether names reveal intent, are pronounceable, and consistent.
  • Functions Check: Ensures functions are small, do one thing, have few arguments, and avoid side effects.
  • Classes Check: Assesses single responsibility, cohesion, encapsulation, and proper abstraction.
  • Patterns & Architecture: Checks for appropriate design patterns, separation of concerns, and inward dependencies.
  • Error Handling & Formatting: Promotes exceptions, clear error context, and readable formatting.
  • Tests & Quality: Reviews test coverage, readability, and reliability of tests.
  • Operational Use: Triggered after code changes or on demand to ensure readiness before delivery.

Quick Start

Use the clean-code-review skill to initiate a comprehensive audit on the latest code changes. Provide the target path or repository as input to receive a structured report detailing findings and recommended fixes.

Frequently Asked Questions about clean-code-review

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

FAQPage Schema
How do I check my codebase against clean code standards before merging?

To check your codebase against clean code standards before merging, initiate a comprehensive audit on the target path to receive a structured report detailing violations and recommended fixes.

What does a clean code review cover when auditing code quality?

A clean code review covers naming, functions, classes, error handling, formatting, tests, architecture, and professional standards to identify violations and provide actionable remediation recommendations.

Can I use this to review function arguments and class encapsulation?

Yes, you can use this to review function arguments and class encapsulation. The audit assesses single responsibility, cohesion, encapsulation, and ensures functions are small with few arguments and no side effects.

What is the best way to ensure my functions follow the single responsibility principle?

The best way to ensure functions follow the single responsibility principle is running an audit that evaluates whether functions do one thing, have few arguments, and assesses classes for proper abstraction and separation of concerns.

How are clean code violations reported during a code quality check?

During a code quality check, clean code violations are reported as actionable findings categorized by severity, complete with specific remediation recommendations to fix naming, architecture, or test issues.

Does a clean code audit verify test coverage and test readability?

Yes, a clean code audit verifies test coverage and test readability. It reviews tests and quality by evaluating the coverage, readability, and reliability of tests within the provided repository path.