Skip to main content
skill CX Codex

clean-code · ciembor — Claude Code skill: rules and installation

This Claude Code skill applies clean-code guidance to readability, naming, and function design. It activates during everyday coding and test-related tasks.

MIT 683 installs ★ 3,328 updated 2026-09-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ciembor/agent-rules-books --skill clean-code -a claude-code
Open on GitHub

What clean-code does

The skill guides changes to readable code, clear names, and small functions with distinct responsibilities. It also covers comments, error handling, and tests.

Before making code or design choices, the agent reads clean-code.mini.md. The longer clean-code.md file is a reference for cases where the short rules do not settle a code-quality tradeoff.

What it helps with

  • make existing code easier to read
  • choose clearer names for functions and variables
  • separate responsibilities across functions
  • prepare code for testing

Example prompts for the agent

  • Improve this function’s readability and choose clearer names.
  • Separate the responsibilities in this code and add suitable tests.
  • Review the error handling and comments in this implementation.

How to install clean-code

1Skills CLI (Vercel)

npx skills add ciembor/agent-rules-books --skill clean-code -a claude-code

2Manually: put the files in place

~/.claude/skills/clean-code/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/clean-code/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about clean-code

How do I install clean-code in Claude Code?

Run npx skills add ciembor/agent-rules-books --skill clean-code -a claude-code. The skill file is located at ~/.claude/skills/clean-code/SKILL.md.

What does clean-code do?

It guides the agent on readability, naming, function design, comments, errors, and tests. The agent starts with clean-code.mini.md and consults clean-code.md when the short rules do not cover the current tradeoff.

When does clean-code use its longer reference?

The agent consults clean-code.md when the guidance in clean-code.mini.md is not enough to decide a code-quality question.

Source text

SKILL.md · MIT
---
name: clean-code
description: Apply Robert C. Martin-inspired clean code rules when improving readability, naming, function design, responsibilities, or testable everyday code.
license: MIT
---

# Clean Code Skill

Use this skill when a task involves everyday implementation quality, naming, small functions, readable control flow, responsibilities, comments, errors, or tests.

Before making design or code decisions, read and apply [clean-code.mini.md](clean-code.mini.md). Use [clean-code.md](clean-code.md) only as a deeper reference when the mini rules are not enough for the current code-quality tradeoff.

© ciembor · MIT · ciembor/agent-rules-books

Similar skills

All skills for Code review and refactoring →

clean-code by other authors comes first.

clean-code sickn33 This skill guides code reviews and refactors using Clean Code principles, from clearer names to simpler functions. Use it when working on new code or legacy code. CX Codex +1 13,100installs clean-code wondelai clean-code — a skill that gives coding agents a readability standard: names that carry intent, small functions, disciplined comments, one error-handling style. CX Codex +1 7,200installs clean-code decebals clean-code guides your coding assistant to write readable code using DRY, KISS, and YAGNI principles. Useful when dealing with bloated methods and vague naming. CX Codex +1 448installs clean-code pproenca Loads 48 rules from Robert C. Martin's Clean Code handbook. It kicks in during code review, naming, function design, and test writing. CX Codex +1 871installs clean-code davila7 Gives the agent a set of clean-code rules: small functions, intent-revealing names, no obvious comments, no needless abstraction. Useful when you want working code, not a tutorial. CX Codex +1 7,176installs clean-architecture wondelai clean-architecture — a skill that keeps business rules independent of framework and database by enforcing one rule: source code dependencies point inward. CX Codex +1 8,000installs clean-code-guard amElnagdy clean-code-guard reviews fresh code against Clean Code and SOLID, flags the mistakes LLMs keep repeating, and runs in three modes: guard pass, live, review. CX Codex +1 4,900installs clean-code-principles AsyrafHussin clean-code-principles — a skill for architecture review and code quality: SOLID, DRY, KISS, design patterns. Useful when refactoring or weighing design decisions. CX Codex +1 1,900installs typescript-clean-code bmad-labs typescript-clean-code — a skill for reviewing and refactoring TypeScript: code smell catalogs, four detection layers, and step-by-step workflows. CX Codex +1 669installs clean-code-ts-react pproenca clean-code-ts-react adapts Robert C. Martin's Clean Code principles for TypeScript 5.x and React 19. Guides code reviews, component architecture, and refactoring sessions. CX Codex +1 238installs code-refactoring-refactor-clean rmyndharis The code-refactoring-refactor-clean Claude Code skill restructures existing code using clean-code principles and SOLID patterns. It activates for tangled modules, duplication, and testability work. CX Codex +1 154installs

From the same set14

The whole set →
refactoring This Claude Code skill applies Martin Fowler-inspired rules to refactoring. It activates for code-structure changes that preserve observable behavior. CX Codex +1 670installs clean-architecture This Claude Code skill applies clean architecture principles to decisions about separating business policy from implementation details. It activates for work on dependency direction, use cases, and application boundaries. CX Codex +1 645installs a-philosophy-of-software-design The a-philosophy-of-software-design Claude Code skill applies software design principles to complexity, module boundaries, APIs, and abstractions. It activates during design reviews or refactoring of shallow interfaces. CX Codex +1 643installs code-complete The code-complete Claude Code skill applies software construction rules to routines, classes, control flow, defensive code, and tests. It activates for implementation and design tasks. CX Codex +1 611installs release-it The release-it Claude Code skill applies production reliability rules to failure handling, timeouts and retries. It activates on tasks involving integration failures, deployment or operational readiness. CX Codex +1 607installs the-pragmatic-programmer the-pragmatic-programmer — a skill for Claude Code and Codex applying Hunt and Thomas-inspired engineering guidelines. Triggers during architecture decisions, automation work, and code refactoring. CX Codex +1 603installs working-effectively-with-legacy-code working-effectively-with-legacy-code — a skill for Claude Code and Codex that enforces Michael Feathers' legacy code techniques. Activates during risky refactoring, missing test coverage, and dependency breaking. CX Codex +1 602installs refactoring-guru refactoring-guru — a skill for Claude Code helps diagnose code smells and choose focused refactoring techniques. The agent applies its rules to code changes while preserving behavior. CX Codex +1 598installs

Project sponsors

Companies that keep this analytics open