clean-code

Enforce clean code practices across Java, Python, Kotlin, Rust, and C++.

5|1|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/roanbrasil/engineer-grade-agent-skills --skill clean-code-roanbrasil
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/roanbrasil/engineer-grade-agent-skills/tree/main/skills/clean-code
Command: npx skills add https://github.com/roanbrasil/engineer-grade-agent-skills --skill clean-code-roanbrasil

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unstructured, hard-to-read code slows down development, increases bug risk, and accumulates technical debt over time, making it difficult for teams to maintain and extend existing codebases.

Core Features & Use Cases

  • Enforces intent-revealing naming conventions for variables, functions, classes, and modules across all programming languages
  • Guides creation of small, single-responsibility functions with consistent abstraction levels and proper command-query separation
  • Provides best practices for error handling, comments, third-party code boundaries, and systematic refactoring
  • Includes a comprehensive code smell reference with targeted refactoring patterns and multi-language idiomatic examples for Rust, Python, Java, Kotlin, and C++
  • Use when writing new features, conducting code reviews, or refactoring legacy code to improve long-term maintainability

Quick Start

Use the clean-code skill to refactor the provided legacy payment processing function to follow single-responsibility principles and use meaningful, searchable variable names.

Frequently Asked Questions about clean-code

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

FAQPage Schema
How do I refactor legacy code to improve readability and reduce technical debt?

To refactor legacy code and reduce technical debt, apply single-responsibility principles, enforce intent-revealing naming conventions, and eliminate code smells using targeted refactoring patterns. This ensures long-term maintainability and lowers bug risk across your codebase.

What are code smells and how do I eliminate them in Python and Java?

Code smells are structural weaknesses in code that increase maintenance risk. You eliminate them by applying systematic refactoring patterns, proper error handling, and multi-language idiomatic examples to ensure clean, readable code across Python and Java.

Can I use clean code practices for code reviews across multiple programming languages?

Yes, you can enforce clean code practices during code reviews across Java, Python, Kotlin, Rust, and C++. The process checks for consistent naming conventions, proper command-query separation, and single-responsibility functions.

What is the best way to structure functions to prevent high-maintenance code?

The best way to prevent high-maintenance code is building small, single-responsibility functions with consistent abstraction levels. Proper command-query separation and meaningful variable names further reduce unstructured, hard-to-read logic.

When do I need to enforce naming conventions and code boundaries?

You need to enforce naming conventions and third-party code boundaries when writing new features or refactoring existing codebases. This professional coding discipline prevents bug accumulation and slows down development cycles.