clean-code

Enforce pragmatic coding standards for AI-assisted software development.

1|Updated Sep 25, 2025
One-click install
npx skills add https://github.com/arroschaves/brandaocontador-site --skill clean-code-arroschaves
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/arroschaves/brandaocontador-site/tree/main/.agent/skills/clean-code
Command: npx skills add https://github.com/arroschaves/brandaocontador-site --skill clean-code-arroschaves

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 concise, direct, and avoids over-engineering, leading to more maintainable and understandable software.

Core Features & Use Cases

  • Coding Standards Enforcement: Adheres to principles like SRP, DRY, KISS, and YAGNI.
  • Naming Conventions: Provides clear rules for variables, functions, and constants.
  • Code Structure Guidelines: Promotes guard clauses, flat structures, and composition.
  • AI Coding Style: Directs AI behavior for feature implementation, bug fixing, and requirement clarification.
  • Verification Scripts: Includes mandatory checks for linting, type coverage, and i18n.
  • Use Case: When asked to refactor a complex function, this Skill ensures the resulting code is simple, well-named, and adheres to single responsibility.

Quick Start

Apply the clean-code skill to refactor the provided user authentication module for better 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 standards during AI-assisted software development?

Clean code standards are enforced by applying pragmatic coding principles like SRP, DRY, KISS, and YAGNI to ensure code remains concise, direct, and avoids over-engineering. This includes specific guidelines for naming conventions, code structure, and AI interaction behavior.

What is the best way to refactor a complex function for better readability and maintainability?

The best way to refactor for readability is to apply guard clauses, promote flat structures, and use composition. This ensures the resulting code is simple, well-named, and adheres to single responsibility principles without introducing unnecessary complexity.

How do coding standards handle verification for linting, type coverage, and internationalization?

Coding standards handle verification by requiring adherence to specific scripts that perform mandatory checks for linting, type coverage, and i18n. These scripts ensure that the generated code meets structural and quality baseline requirements before completion.

When do I need pragmatic programming principles to prevent over-engineering in my codebase?

You need pragmatic programming principles when your codebase becomes difficult to maintain or understand due to unnecessary complexity. Applying these principles directs feature implementation and bug fixing toward conciseness and directness, preventing over-engineering.

Does this approach to code quality work without relying on external dependencies?

Yes, this approach to code quality works without external dependencies, as it relies entirely on built-in scripts and reference guidelines. It enforces coding standards and structural rules internally rather than requiring third-party libraries or frameworks.