clean-code

Enforce pragmatic coding standards for AI agents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill enforces pragmatic, clean code principles to ensure code is concise, maintainable, and efficient, avoiding unnecessary complexity and technical debt.

Core Features & Use Cases

  • Code Quality Enforcement: Adheres to principles like SRP, DRY, KISS, and YAGNI.
  • Clear Naming Conventions: Promotes descriptive variable, function, and constant names.
  • Function Design: Guides the creation of small, single-purpose functions with limited arguments.
  • Code Structure: Encourages guard clauses, flat code, and composition over deep nesting.
  • AI Coding Style: Defines how AI agents should interact with user requests for code.
  • Anti-Pattern Avoidance: Lists common pitfalls and their corrections.
  • Pre-Edit Checks: Ensures developers consider impact before modifying files.
  • Post-Completion Self-Checks: Mandates thorough verification before task completion.
  • Script Execution & Output Handling: Defines how validation scripts are run and their results summarized.

Quick Start

Apply the clean code principles to refactor the provided UserService.ts file.

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 standards during AI-assisted development?

To enforce clean code standards during AI development, apply rules that guide AI agents toward conciseness, maintainability, and efficiency. These standards ensure adherence to SRP, DRY, KISS, and YAGNI principles, preventing unnecessary complexity and technical debt.

What are the best practices for refactoring code to improve maintainability?

Best practices for refactoring code to improve maintainability involve creating small, single-purpose functions with limited arguments. You should use clear naming conventions, implement guard clauses, prefer flat code structures, and choose composition over deep nesting to reduce complexity.

How do I prevent common coding anti-patterns when generating scripts?

To prevent common coding anti-patterns when generating scripts, utilize defined AI coding styles that list frequent pitfalls alongside their corrections. This approach promotes a direct, solution-oriented methodology, ensuring generated code avoids deep nesting and unnecessary variables.

Can I use coding standards to run validation scripts and handle output?

Yes, you can use coding standards to define how validation scripts are executed and how their results are summarized. This includes mandating thorough post-completion self-checks and pre-edit impact considerations to verify code quality before finalizing tasks.

When do I need to apply pre-edit checks for code structure modifications?

You need to apply pre-edit checks for code structure modifications whenever altering existing files. These checks ensure you consider the impact before modifying code, enforcing a direct, solution-oriented approach to coding tasks and maintaining structural integrity.