clean-code

Identify Clean Code issues and refactoring opportunities in software projects.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/remiconnesson/insights-garden --skill clean-code-remiconnesson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/remiconnesson/insights-garden/tree/main/.agents/skills/clean-code
Command: npx skills add https://github.com/remiconnesson/insights-garden --skill clean-code-remiconnesson

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps developers identify and improve code that is hard to read, hard to change, or hard to test. It turns Clean Code principles into practical review and refactoring guidance.

Core Features & Use Cases

  • Naming guidance for variables, functions, classes, and files.
  • Function design advice for size, single responsibility, abstraction level, and side effects.
  • Error handling, object boundaries, class organization, formatting, and unit test quality.
  • Use it when reviewing pull requests, planning refactors, writing new code, or cleaning up legacy systems.

Quick Start

Paste the code or describe the refactor goal, and ask for a Clean Code review that highlights naming, function, error-handling, boundary, and test improvements.

Frequently Asked Questions about clean-code

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

FAQPage Schema
How do I refactor code for better readability and maintainability?

To refactor code for readability and maintainability, paste your code and request a review that identifies naming issues, oversized functions, unclear error handling, and boundary violations. This provides actionable guidance to split responsibilities and apply clean code principles.

What is the best way to review code for clean code violations in a pull request?

The best way to review code for clean code violations is to analyze the pull request diff for intent-revealing names, small focused functions, explicit error handling, and clear test design. Paste the code to highlight refactoring opportunities before merging.

Can I get naming guidance for variables and functions during a code review?

Yes, you can get naming guidance for variables, functions, classes, and files during a code review. Provide the code snippet to receive suggestions for intent-revealing names that improve overall readability and maintainability.

How do I improve unit test quality when cleaning up legacy code?

Improve unit test quality in legacy code by analyzing test design for clarity and coverage alongside the refactored code. Paste your tests to ensure they validate behavior effectively without coupling to implementation details.

Does this clean code review approach work for object boundaries and class structure design?

Yes, this clean code review approach works for object boundaries and class structure design by evaluating dependency limits and class organization. Paste your class definitions to identify boundary violations and structural improvements.

When should I not use automated refactoring suggestions for error handling?

Avoid automated refactoring suggestions for error handling when complex domain rules require explicit, custom logic that generic clean code patterns cannot interpret. Review suggested changes manually to ensure error handling remains contextually accurate.