clean-code

Enforce pragmatic coding standards for AI-generated code.

Updated Dec 24, 2025
One-click install
npx skills add https://github.com/OmarMira/Coontabilidad --skill clean-code-omarmira
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/OmarMira/Coontabilidad/tree/main/.agent/skills/clean-code
Command: npx skills add https://github.com/OmarMira/Coontabilidad --skill clean-code-omarmira

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enforces pragmatic coding standards to ensure code is maintainable, efficient, and easy to understand, preventing over-engineering and unnecessary complexity.

Core Features & Use Cases

  • Enforces SOLID principles: Promotes Single Responsibility and Don't Repeat Yourself.
  • Simplifies code structure: Encourages small functions, guard clauses, and flat nesting.
  • Use Case: When refactoring a large, complex function, this Skill guides the AI to break it down into smaller, single-purpose functions, improving readability and testability.

Quick Start

Apply the clean-code skill to refactor the provided UserService.ts file to adhere to SRP and DRY principles.

Frequently Asked Questions about clean-code

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

FAQPage Schema
How do I refactor a large, complex function to improve readability and testability?

Refactoring a complex function involves breaking it down into smaller, single-purpose functions guided by the Single Responsibility Principle, improving overall code readability and testability.

What are the best coding standards to prevent over-engineering in software design?

To prevent over-engineering in software design, apply pragmatic coding standards like KISS and YAGNI, which discourage unnecessary complexity and focus on concise, direct code implementation.

How do I apply the DRY principle to eliminate duplicate code in my scripts?

Applying the DRY principle eliminates duplicate code by enforcing standards that guide you to consolidate redundant logic into reusable, single-purpose functions, improving maintainability.

Does AI-generated code need specific coding etiquette and self-verification steps?

AI-generated code requires specific coding etiquette and self-verification steps to ensure naming conventions, function design, and code structure adhere to pragmatic, maintainable standards.

What's the best way to simplify code structure when dealing with deeply nested logic?

Simplifying code structure with deeply nested logic involves using guard clauses to flatten nesting and encouraging small functions, resulting in more maintainable and direct code.