Hands-OnAI
← All skills
AutomationNewFreeWorks in Claude Code · Claude app · Codex

Clean Code

Write readable, maintainable code with disciplined naming and small functions. (For developers.)

Part of Book skills by @wondelai ↗

Applies Robert Martin's Clean Code principles — clear naming, small functions, clean error handling — for maintainable code.

What it does

  • Improves naming, function size, and structure.
  • Cleans up smells for readable code.

When it kicks in

Write readable, maintainable code through disciplined naming, small functions, and clean error handling. Use when the user mentions "clean up this code", "this function is too long", "code smells", "naming conventions", "boy scout rule", "single responsibility", or "unit test quality". Also trigger when reviewing a pull request for readability, untangling a messy function, debating comment styles, or improving error-handling patterns.

Topics the skill covers

  • Core Principle
  • Meaningful Names
  • Functions
  • Comments and Formatting
  • Error Handling
  • Unit Testing
  • Code Smells and Heuristics
  • Common Mistakes

What's inside the download

7 files in the .zip:

  • Skill InstructionsSKILL.md14.6 KB
  • Code Smellsreferences/code-smells.md16 KB
  • Comments Formattingreferences/comments-formatting.md12.5 KB
  • Error Handlingreferences/error-handling.md12.3 KB
  • Functions and Methodsreferences/functions-and-methods.md12.3 KB
  • Naming Conventionsreferences/naming-conventions.md11 KB
  • Testing Principlesreferences/testing-principles.md12.6 KB

How to install (2 minutes)

Same download for Claude Code, Claude app, Codex — follow the step for the tool you use.

  1. 1Download the .zip and unzip it — you’ll get a folder called clean-code.
  2. 2In the Claude app: open Settings → Capabilities → Skills, choose Add / Upload, and select the folder (or the .zip).
  3. 3In Claude Code: drop the folder into your project’s .claude/skills/ directory, then type /skills to confirm it loaded.
  4. 4In Codex: drop the folder into ~/.agents/skills/ (or your project’s .agents/skills/), then type /skills — or call it directly with $clean-code.
  5. 5That’s it — the skill activates on its own when it fits what you’re doing.

New to skills? Our Claude Cowork beginner's guide shows how they work inside Claude.

Want to get the most out of your new skill?

Inside Hands-On AI Club we show you exactly how to use skills like this in real work — with step-by-step courses that show every move.