How does it handle complex functions?

It enforces a 20-line maximum and single responsibility principle, breaking complex logic into small, composable functions with one level of abstraction.

What makes this skill 'pragmatic'?

It focuses on the simplest solution that works (KISS) and avoids building features that aren't immediately needed (YAGNI), preventing over-engineering.

Does this skill add comments to my code?

No, it actually removes unnecessary comments, favoring self-documenting code and clear naming conventions that explain the logic through the code itself.

Can it verify its own changes?

Yes, it includes mandatory verification scripts for linting, type coverage, and specific domain audits like API, Security, or UX checks.

Pragmatic Clean Code

Name: Pragmatic Clean Code
Author: claudiodearaujo

byclaudiodearaujo

0•

Developer Tools

Enforces concise, direct coding standards and pragmatic architecture to eliminate over-engineering and technical debt.

The Pragmatic Clean Code skill transforms Claude into a high-seniority developer focused on maintainability and efficiency. It implements core industry principles like SRP, DRY, and KISS while strictly avoiding unnecessary comments, deep nesting, and over-engineered abstractions. By prioritizing early returns, small functions, and clear naming conventions, this skill ensures that generated code is production-ready, readable, and focused on solving the user's problem without redundant explanations or tutorial-like narratives.

Key Features

01Optimizes function structure with guard clauses and flat nesting limits.

02Includes mandatory pre-edit dependency checks and post-task verification scripts.

03Enforces SRP, DRY, and KISS principles for modular and reusable code.

040 GitHub stars

05Automates clear, intent-based naming for variables, functions, and booleans.

06Eliminates 'tutorial-style' AI chatter in favor of direct code solutions.

Use Cases

01Refactoring legacy code to improve readability and reduce technical debt.

02Standardizing a codebase following industry-best naming and structural conventions.

03Streamlining AI-generated code to remove verbosity and unnecessary comments.

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