This is Robert C. Martin's Clean Code handbook distilled into 48 rules across naming, functions, comments, formatting, and error handling. It triggers during code reviews, refactoring, and when you're debating what to call something. The rules are prioritized by impact, so you know meaningful names and small functions matter more than test patterns. Examples are Java-heavy but the principles translate. The skill includes modern corrections where Uncle Bob's 2008 advice has aged poorly. Honestly most useful as a shared vocabulary for code review discussions rather than gospel, since some rules like "one assert per test" remain contentious fifteen years later.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.
5
skills.sh installs
857
GitHub stars
222
last updated
Aug 21, 2026

Install

$ npx -y skills add pproenca/dot-skills --skill clean-code --agent claude-code

Installs into .claude/skills of the current project.

Files

Robert C. Martin (Uncle Bob) Clean Code Best Practices

Comprehensive software craftsmanship guide based on Robert C. Martin's "Clean Code: A Handbook of Agile Software Craftsmanship", updated with modern corrections where the original 2008 advice has been superseded. Contains 48 rules across 10 categories, prioritized by impact to guide code reviews, refactoring decisions, and new development. Examples are primarily in Java but principles are language-agnostic.

When to Apply

Reference these guidelines when:

  • Writing new functions, classes, or modules
  • Naming variables, functions, classes, or files
  • Reviewing code for maintainability issues
  • Refactoring existing code to improve clarity
  • Writing or improving unit tests
  • Wrapping third-party dependencies

Rule Categories by Priority

Sponsors

Details

Repository
github.com/pproenca/dot-skills
Categories
Testing & QA, Documentation, Code Review & Quality, Debugging, Design & UI/UX
First seen
Jun 3, 2026

More from pproenca/dot-skills

All 100
1joellewis avatarstatistics-fundamentalsjoellewis/finance_skillsApply statistical methods to financial data including descriptive statistics, covariance estimation, regression, hypothesis testing, and resampling. Use when th856skills.sh installs
2martinholovsky avatarui-ux-expertmartinholovsky/claude-skills-generatorExpert UI/UX designer specializing in user-centered design, accessibility (WCAG 2.2), design systems, and responsive interfaces. Use when designing web/mobile a830skills.sh installs
3product-on-purpose avatarmeasure-experiment-designproduct-on-purpose/pm-skillsDesigns an A/B test or experiment with variants, success metrics, sample size, and duration for an existing hypothesis. Use when planning an experiment to valid801skills.sh installs
4product-on-purpose avatarfoundation-personaproduct-on-purpose/pm-skillsGenerates an evidence-calibrated product or marketing persona using the canonical v2.5 output contract. Use when shaping artifact perspective, stress-testing de792skills.sh installs
5mblode avatarscaffold-climblode/agent-skillsScaffolds a production-ready TypeScript CLI and npm package with ESM, a dual tsdown build (CLI binary plus typed library), vitest, oxlint and oxfmt via ultracit751skills.sh installs
6alirezarezvani avatarad-creativealirezarezvani/claude-skillsWhen the user needs to generate, iterate, or scale ad creative for paid advertising. Use when they say 'write ad copy,' 'generate headlines,' 'create ad variati733skills.sh installs