Clean Code

Uncle Bob's Clean Code framework as a scored 0-10 rubric with six disciplines and reference deep-dives.

Tested · Works

Test report

Verdict
Tested · Works
Score
9.2/10
Tested
Jul 10, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · 84a8a50

Ran a genuinely messy 5-line function through it: baseline just renamed variables, but the skill scored it 3/10, named the exact violations (flag argument breaking command-query separation, magic number for the op type, a dead unused parameter) and split it into two properly-named functions instead of a generic tidy-up.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 5/5
  • Output vs. baseline 8/10
  • Docs & honesty 5/5

What Clean Code does

Reviews or writes code against six clean-code disciplines (naming, functions, comments/formatting, error handling, unit testing, code smells), scoring it 0-10 and pointing to specific reference files for deep dives. Triggers on phrases like 'clean up this code', 'this function is too long', 'code smells', or 'single responsibility', and explicitly defers to sibling skills for architecture/refactoring-technique questions.

How to install Clean Code

git clone https://github.com/wondelai/skills
cd skills
mkdir -p ~/.claude/skills
cp -r clean-code ~/.claude/skills/clean-code

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Clean Code

  • /clean-code Uncle Bob's Clean Code framework as a scored 0-10 rubric with six disciplines and reference deep-dives.

It also activates on plain-language prompts like these:

  • Score this function's clean-code quality from 0 to 10
  • This function is too long, help me clean it up
  • Check this code for smells and bad naming issues

Frequently asked questions

Is the Clean Code skill free?
Yes. The skill itself is free from wondelai/skills. SkillProof publishes the install command and an independent test verdict at no cost.
Does Clean Code work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 10, 2026. Verdict: Tested · Works. Ran a genuinely messy 5-line function through it: baseline just renamed variables, but the skill scored it 3/10, named the exact violations (flag argument breaking command-query separation, magic number for the op type, a dead unused parameter) and split it into two properly-named functions instead of a generic tidy-up.
What is the Clean Code SkillProof Score?
9.2/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 8/10, docs & honesty 5/5.
How do I install Clean Code?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Clean Code with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.