clean-code

Apply pragmatic clean-code rules to writing, editing, or refactoring code.

8|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/gabriellpequeno/Reserva-Aqui---Projeto-de-fim-de-ciclo --skill clean-code-gabriellpequeno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/gabriellpequeno/Reserva-Aqui---Projeto-de-fim-de-ciclo/tree/main/.cursor/skills/clean-code
Command: npx skills add https://github.com/gabriellpequeno/Reserva-Aqui---Projeto-de-fim-de-ciclo --skill clean-code-gabriellpequeno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Padroes pragmáticos de código limpo ajudam equipes a escrever, ler e manter código com menos defeitos, evitando complexidade desnecessária. Use ao escrever, editar ou refatorar código.

Core Features & Use Cases

  • Regras pragmáticas que priorizam legibilidade, simplicidade e robustez.
  • Guard clauses para reduzir aninhamento e falhas.
  • Funções pequenas com responsabilidade única e nomes claros.

Quick Start

Aplique regras pragmáticas de código limpo a uma função pequena para melhorar legibilidade e segurança.

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 that reduce nesting and prevent failures. They improve code readability by handling edge cases upfront, keeping the main logic flat and simplifying maintainability.

How do I refactor a large function to follow the single responsibility principle?

Refactor for single responsibility by breaking large functions into smaller, focused units. Each small function should handle one clear task with a descriptive name, minimizing complexity and reducing potential defects.

Does applying clean code rules work for both individual functions and entire modules?

Yes, pragmatic clean-code rules apply to individual functions, modules, and team workflows. They enforce clear naming and single responsibility, ensuring readability and fewer defects across any codebase scope.

What's the best way to write maintainable code without unnecessary comments?

Write maintainable code with minimal comments by using clear, descriptive naming for functions and variables. This approach prioritizes self-documenting logic, ensuring the code explains its intent and reduces defects.

When should I not use clean code refactoring techniques?

Avoid refactoring when changes cannot be validated for safety or long-term maintainability. If splitting functions or adding guard clauses introduces performance bottlenecks or breaks tests, the pragmatic approach should be adjusted.