sfermanelli-clean-code

What problem does it solve?

Messy, inconsistent code makes maintenance costly and onboarding slow. This Skill guides you to improve readability and maintainability without altering behavior.

Core Features & Use Cases

• Meaningful Names: enforce intention-revealing identifiers and avoid misleading names.
• Functions: keep functions short, do one thing, and apply guard clauses to flatten logic.
• TypeScript-Specific Clean Patterns: use readonly where appropriate, narrow types, and prefer discriminated unions.
• Comments: explain why, not what, and remove redundant commentary.
• Formatting: organize imports, structure code for the "newspaper" flow, and align sections.
• The Law of Demeter: minimize chained access and encourage telling objects to do the work.

Quick Start

Run a guided clean-up pass on a TypeScript file to improve naming, structure, and comments while preserving behavior.