clean-code

Enforce pragmatic coding standards for concise, maintainable code.

Updated Jan 20, 2026
One-click install
npx skills add https://github.com/lchenrique/politron-ide --skill clean-code-lchenrique
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/lchenrique/politron-ide/tree/main/.agent/skills/clean-code
Command: npx skills add https://github.com/lchenrique/politron-ide --skill clean-code-lchenrique

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pragmatic coding standards help teams avoid over-engineering, remove unnecessary commentary, and keep code concise and maintainable.

Core Features & Use Cases

  • Concision: Encourage short, readable functions and components.
  • Clarity: Use meaningful names and minimize noisy constructs.
  • Robustness: Favor simple, well-tested patterns and early exits.
  • Use Case: On boarding a junior engineer to a legacy codebase, guide refactoring to improve readability and maintainability.

Quick Start

Provide a concise rule set or starter templates to apply clean-code principles to a given function or module.

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 maintainability?

To refactor legacy code for readability, enforce pragmatic coding standards like SRP, DRY, and KISS. This produces concise, direct, maintainable code by applying meaningful naming conventions, small functions, and limited nesting across modules.

What are the best coding standards to apply during a code review?

The best coding standards for code reviews enforce SRP, DRY, KISS, and YAGNI principles. They focus on achieving concision and clarity through meaningful names, small functions, limited nesting, and early exits to ensure maintainable code.

How do I prevent over-engineering when building new software modules?

To prevent over-engineering in software modules, apply YAGNI and KISS principles to favor simple, well-tested patterns. This removes unnecessary commentary and noisy constructs, keeping functions concise, direct, and maintainable.

Can I use clean code principles to onboard a junior engineer to an existing codebase?

Yes, you can use clean code principles to onboard a junior engineer to an existing codebase. Enforcing pragmatic coding standards provides a concise rule set that guides refactoring and improves code readability and maintainability across functions.

What is the difference between clean code and standard refactoring techniques?

Clean code differs from standard refactoring by enforcing preventative coding standards like SRP, DRY, and YAGNI to avoid over-engineering. Refactoring improves existing readability, while clean code principles ensure concise, maintainable code from the start.