clean-code-principles

Review code implementations against Clean Code principles like YAGNI and KISS.

14|1|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/marcioaltoe/claude-craftkit --skill clean-code-principles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code-principles
Source: https://github.com/marcioaltoe/claude-craftkit/tree/main/plugins/architecture-design/skills/clean-code-principles
Command: npx skills add https://github.com/marcioaltoe/claude-craftkit --skill clean-code-principles

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides developers in writing simple, readable, and maintainable code by applying core Clean Code principles. It helps avoid over-engineering, unnecessary complexity, and code duplication, leading to more robust and understandable software.

Core Features & Use Cases

  • KISS (Keep It Simple, Stupid): Encourages solutions that are as simple as possible, avoiding premature optimization and complex abstractions.
  • YAGNI (You Aren't Gonna Need It): Promotes building only what is currently required by the business, preventing speculative features and unused code.
  • DRY (Don't Repeat Yourself): Advocates for abstracting common logic after the "Rule of Three" to reduce duplication and improve maintainability.
  • TDA (Tell, Don't Ask): Guides objects to command actions rather than querying state and then acting on it, improving encapsulation.
  • Use Case: "Review this new feature implementation to ensure it adheres to the YAGNI principle, removing any speculative code that isn't part of the current requirements."

Quick Start

Refactor a function to simplify its logic, applying the KISS principle.