clean-code

Enforce pragmatic coding standards like SRP, DRY, KISS, and YAGNI across projects.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bcassiano/MariIA --skill clean-code-bcassiano
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/bcassiano/MariIA/tree/main/ag_kit_2/.agent/skills/clean-code
Command: npx skills add https://github.com/bcassiano/MariIA --skill clean-code-bcassiano

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pragmatic coding standards guide developers to write concise, direct code and avoid over-engineering or unnecessary comments.

Core Features & Use Cases

  • Enforces SRP, DRY, KISS, YAGNI, and Boy Scout cleanliness to reduce complexity and improve readability.
  • Encourages naming clarity, small functions, guard clauses, and minimal side effects.
  • Use cases include code reviews, onboarding new engineers, and refactoring for maintainability.

Quick Start

Apply SRP, DRY, KISS, and YAGNI first to your module, then iteratively refactor for readability and maintainability.

Frequently Asked Questions about clean-code

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

FAQPage Schema
How do I enforce clean code and coding standards during code reviews?

Clean code reviews enforce pragmatic coding standards like SRP, DRY, KISS, and YAGNI to reduce complexity and improve readability. These standards codify naming conventions and structured function rules into clear, actionable guidance for your team.

What is the YAGNI principle and when should I apply it?

The YAGNI principle prevents over-engineering by avoiding unnecessary code and functionality. Apply YAGNI alongside DRY and KISS to write concise, direct code that prioritizes immediate project maintainability.

How do I refactor a module to follow SRP and DRY principles?

Refactoring for SRP and DRY involves restructuring modules so each function has a single responsibility while minimizing duplicated logic. Iteratively apply guard clauses, ensure clear naming, and remove redundant side effects to improve readability.

Can I use these clean code standards for onboarding new engineers?

Yes, clean code standards are highly effective for onboarding new engineers. They provide a shared set of pragmatic rules, such as Boy Scout cleanliness and naming conventions, that help new team members quickly write maintainable, readable code.

What's the best way to reduce code complexity and improve maintainability?

The best way to reduce code complexity is by following pragmatic coding standards like KISS and YAGNI to avoid over-engineering. Enforce small functions, guard clauses, and minimal side effects to directly improve code readability and maintainability.

Why should I avoid unnecessary comments when writing clean code?

Avoiding unnecessary comments is a pragmatic coding standard that promotes concise, direct code. When naming clarity and small functions following SRP are properly utilized, the code itself becomes self-documenting, reducing the need for redundant explanations.