clean-code SKILL.md skillA

clean-code from b-mendoza/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add b-mendoza/agent-skills/clean-code@git:20260906.c3eb1a3

Pins git:20260906.c3eb1a3 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

b-mendoza/agent-skills

Path

.agents/skills/clean-code/SKILL.md

Versions recorded

3

Latest version

git:20260906.c3eb1a3, committed Sep 6, 2026

First version recorded

Mar 31, 2026

Size

4,835 bytes

Repository stars

3

License

none declared

This skill embodies the principles of "Clean Code" by Robert C. Martin (Uncle Bob). Use it to transform "code that works" into "code that is clean.".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Clean Code Skill

This skill embodies the principles of "Clean Code" by Robert C. Martin (Uncle Bob). Use it to transform "code that works" into "code that is clean."

## 🧠 Core Philosophy
> "Code is clean if it can be read, and enhanced by a developer other than its original author." — Grady Booch

## When to Use
Use this skill when:
- **Writing new code**: To ensure high quality from the start.
- **Reviewing Pull Requests**: To provide constructive, principle-based feedback.
- **Refactoring legacy code**: To identify and remove code smells.
- **Improving team standards**: To align on industry-standard best practices.

## 1. Meaningful Names
- **Use Intention-Revealing Names**: `elapsedTimeInDays` instead of `d`.
- **Avoid Disinformation**: Don't use `accountList` if it's actually a `Map`.
- **Make Meaningful Distinctions**: Avoid `ProductData` vs `ProductInfo`.
- **Use Pronounceable/Searchable Names**: Avoid `genymdhms`.
- **Class Names**: Use nouns (`Customer`, `WikiPage`). Avoid `Manager`, `Data`.
- **Method Names**: Use verbs (`postPayment`, `deletePage`).

## 2. Functions
- **Small!**: Functions should be shorter than you think.
…

Read the whole file at its exact version.

How to install

mdr add b-mendoza/agent-skills/clean-code@sha256:3c4115e1bc0ead5b

[![mdr](https://markdownregistry.com/badge/art_ncjqdtk2zx3vemsu.svg)](https://markdownregistry.com/a/art_ncjqdtk2zx3vemsu)

Versions

The registry has recorded 3 versions of this file, between Mar 31, 2026 and Sep 6, 2026, about one every 79 days.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_ncjqdtk2zx3vemsu
GET https://markdownregistry.com/api/v1/resolve?ref=b-mendoza/agent-skills/clean-code
GET https://markdownregistry.com/api/v1/blob/3c4115e1bc0ead5b023d9cc2c4f79f3a9273bfd363ae5c7eb11cf67f0096f317

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from b-mendoza/agent-skills

Every file in b-mendoza/agent-skills

Other files named clean-code

Browse by kind, by grade A, or by owner.