clean-code

Enforce pragmatic coding standards for concise, maintainable code.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/ricardohg1998-create/Plantilla-repo --skill clean-code-ricardohg1998-create
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/ricardohg1998-create/Plantilla-repo/tree/main/.agent/skills/clean-code
Command: npx skills add https://github.com/ricardohg1998-create/Plantilla-repo --skill clean-code-ricardohg1998-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams adopt pragmatic coding standards, ensuring code is concise, direct, and free of unnecessary comments or over-engineering.

Core Features & Use Cases

  • Enforces SRP, DRY, and KISS principles across functions and classes to improve readability and maintainability.
  • Guides code reviews and refactoring efforts to produce simpler, well-structured code.
  • Use Case: when a module becomes hard to understand due to boilerplate and duplications, apply this skill to streamline logic and improve clarity.

Quick Start

Use clean-code to refactor a verbose function into small, single-responsibility components with clear naming and minimal comments.

Frequently Asked Questions about clean-code

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

FAQPage Schema
What are guard clauses and how do they improve code readability?

Guard clauses are early returns for invalid conditions that flatten nested logic. They improve code readability by making functions concise, direct, and easier to maintain without deep nesting.

How do I refactor a large function into smaller components?

Refactor large functions by applying single responsibility and DRY principles. Break down verbose logic into small, well-named functions with minimal arguments to reduce side effects and improve clarity.

Does this approach to clean code require specific software engineering frameworks?

No, this approach to clean code does not require specific frameworks. It enforces pragmatic coding standards across functions, classes, and modules in any software development environment.

What is the best way to enforce SRP, DRY, and KISS principles during code reviews?

The best way to enforce SRP, DRY, and KISS principles during code reviews is to check for small functions, minimal arguments, and guard clauses to ensure concise, maintainable code without over-engineering.

Why does over-engineering make modules hard to understand?

Over-engineering makes modules hard to understand by introducing unnecessary boilerplate and duplications. Applying clean code standards streamlines logic, ensures clarity, and removes excess comments.

When should I avoid adding comments to my code?

You should avoid adding comments when the code is already concise and direct. Clean code standards favor well-named variables and functions over unnecessary comments to explain logic.