How does this skill handle code documentation?

It follows the 'self-documenting' principle, focusing on clear naming conventions rather than excessive comments. If a comment is needed to explain a name, the skill suggests renaming the element instead.

Does this skill help prevent breaking changes?

Yes, it includes a mandatory 'Think First' checklist that requires checking file dependencies and shared components before any edits are made.

How does the AI behave differently with this skill enabled?

The AI becomes more direct, fixing bugs or implementing features immediately without writing tutorials or long-winded explanations before the code.

What are the limits for function length in this skill?

The skill encourages functions to be small, ideally between 5 to 10 lines and capping at 20 lines, ensuring they perform only one specific task.

What is the primary objective of the Clean Code skill?

The primary objective is to generate concise, direct, and solution-focused code by adhering to pragmatic standards like SRP, KISS, and DRY, avoiding unnecessary complexity.

Clean Code Standards

Name: Clean Code Standards
Author: claudiodearaujo

byclaudiodearaujo

0•

Developer Tools

Enforces pragmatic, high-quality coding standards to ensure codebases remain maintainable, concise, and free of over-engineering.

The Clean Code skill equips Claude with a set of pragmatic engineering principles designed to eliminate technical debt and unnecessary bloat. It prioritizes core software patterns such as Single Responsibility (SRP), DRY, and KISS while enforcing strict naming conventions and function size limits. By focusing on direct solutions and avoiding excessive comments or complex abstractions, this skill ensures that AI-generated code is production-ready, readable, and highly maintainable. It also incorporates a critical 'Think First' checklist to ensure that changes don't break dependencies or shared components across the project.

Key Features

01Reduces code bloat by eliminating redundant comments and over-engineered patterns

02Implements guard clauses and flat structures to minimize deep nesting

030 GitHub stars

04Limits function complexity and length to improve readability and testing

05Automates naming convention checks for variables, functions, and booleans

06Enforces SRP, DRY, KISS, and YAGNI principles for leaner code

Use Cases

01Rapidly implementing features without accumulating technical debt

02Ensuring consistent coding standards across a large-scale project

03Refactoring legacy code to improve long-term maintainability

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claudiodearaujo/sistema-de-narra-o-de-livro-front clean-code

For use in Claude.ai and ChatGPT

Download Skill