Agent skill · software engineering · aiskillstore
clean-code
Clean code principles for readable, maintainable software
Why this skill is useful
Codifies naming conventions and function design principles that the AI could infer but now doesn't have to guess.
What it needs
About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Clean Code Principles Write code that humans can understand. Code is read far more often than it's written. Naming Variables Functions Booleans Functions Single Responsibility Few Parameters Avoid Flag Arguments Return Early Comments Don't Comment Bad Code - Rewrite It Good Comments Error Handling Don't Return Null Don't Pass Null Formatting Consistent Style Pick a style guide (Prettier, StandardJS, Black) Automate with formatters Never debate style in code review Vertical Density Code Smells to Avoid Smell Problem Solution ------- --------- ---------- Long Method Hard to understand Extract methods Long Parameter List Complex interface Parameter object Duplicate Code Change in multiple places Extract function Dead Code Confusion, maintenance Delete it Magic Numbers Unclear meaning Named constants Deep Nesting Hard to follow Early returns, extract Feature Envy Wrong location Move method Data Clumps Always together Create class The Boy Scout Rule Leave the code cleaner than you found it. Every commit should improve code quality slightly. Small, incremental improvements compound over time. Checklist Before committing, ask: [ ] Can I understand this code in 6 months? [ ] Would a new team member understand it? [ ] Are names descriptive and searchable? [ ] Does each function do one thing? [ ] Are there any magic numbers/strings? [ ] Is error handling appropriate? [ ] Did I remove all dead code?
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/clean-code