One-click install
npx skills add https://github.com/thgterto/Gerenciador-de-estoque --skill clean-code-thgterto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/thgterto/Gerenciador-de-estoque/tree/main/.agent/skills/clean-code
Command: npx skills add https://github.com/thgterto/Gerenciador-de-estoque --skill clean-code-thgterto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pragmatic coding standards reduce over-engineering, eliminate unnecessary comments, and keep AI-generated code concise, readable, and maintainable.

Core Features & Use Cases

  • Enforces SRP, DRY, KISS, and YAGNI to produce clean, focused code.
  • Provides naming, structure, and guard-rail guidelines to improve readability and maintainability.
  • Use Case: Apply these rules during feature development or code reviews to ensure small, testable units with clear intent.

Quick Start

Follow the naming, structure, and guardrail rules in your next coding task.

Frequently Asked Questions about clean-code

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

FAQPage Schema
How do I apply clean code standards to AI-generated code?

Clean code standards improve AI-generated code by enforcing SRP, DRY, KISS, and YAGNI principles. This strict application ensures output remains concise, readable, and maintainable by reducing over-engineering and eliminating unnecessary comments.

What are the best practices for reducing deep nesting in software engineering?

Best practices for reducing deep nesting involve using guard clauses and descriptive naming conventions. These structural guardrails keep code focused, testable, and readable across day-to-day software development tasks.

How do I prevent over-engineering during feature development?

Prevent over-engineering during feature development by applying strict coding standards like YAGNI and KISS. This pragmatic approach eliminates unnecessary complexity and ensures your software units remain small and focused.

Does this approach work for code review scenarios?

Yes, this approach works for code review scenarios by applying coding standards to verify single-responsibility, minimal arguments, and guard clauses. It ensures reviewed code meets functional requirements for readability and maintainability.

What is the impact of strict naming conventions on code maintainability?

Strict naming conventions directly improve code maintainability by providing clear intent and structural guidelines. Descriptive naming acts as a functional guardrail, making software engineering code easier to read and maintain over time.