clean-code is agent-read markdown (skill) from flurdy/agent-skills: Format, lint, and fix all warnings across the entire codebase — including test files and pre-existing issues..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Clean Code
Format, lint, and fix all warnings across the entire codebase — including test files and pre-existing issues.
## Usage
```
/clean-code
```
## Instructions
### 1. Run the project's clean-code target
Each project defines a `make clean-code` Makefile target with the appropriate tooling for its language/stack.
```bash
make clean-code
```
### 2. Fix remaining issues
If `make clean-code` fails or reports warnings/errors that couldn't be auto-fixed, investigate and fix them manually. Do NOT leave any warnings unresolved.
### 3. Verify clean state
Re-run the target to confirm it passes cleanly:
```bash
make clean-code
```
It must exit with zero warnings and zero errors.
## Rules
- Do not skip or suppress warnings (e.g. `eslint-disable`, `#[allow(...)]`, `@SuppressWarnings`) unless there is a genuine false positive with a clear justification
- Do not change the project's formatter or linter configuration
- If a fix changes behavior (not just style), flag it to the user before applying
- Test files are in scope — do not skip them
- Pre-existing issues must be fixed, not just new code
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
A 17 of 17 checks passed. Deterministic, no model, same answer every run.
pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (1422 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag
Source
GitHub
flurdy/agent-skills · 9 stars · license MIT · pushed 2026-09-23 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_aql5csmrtyf7aqcf
GET https://markdownregistry.com/api/v1/resolve?ref=flurdy/agent-skills/clean-code
GET https://markdownregistry.com/api/v1/blob/24fbb5ccacd008969050adee33881b1525bfbe0bcc1f52345089e5a59e38b40d
Your agent 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.
flurdy/agent-skills · skills/artifact-hygiene/SKILL.md · Run a local-only, read-only advisory audit of publishable working-tree files and unpublished branch history with…
flurdy/agent-skills · skills/beads-migrate-to-dolt/SKILL.md · Safely migrate classic Beads data or upgrade a Dolt schema, preserving backups and remote history. Repository aftercare…
flurdy/agent-skills · skills/beads-setup/SKILL.md · Preview and separately confirm a fresh repository Beads store with a dedicated private GitHub Dolt remote. Refuses…
flurdy/agent-skills · skills/browser-screenshot/SKILL.md · Take a screenshot of the running web application for visual verification of UI/CSS changes. Use when iterating on…
flurdy/agent-skills · skills/circleci-status/SKILL.md · Check CircleCI build status and failed job logs for the current GitHub repository. Use when asked whether CircleCI is…
flurdy/agent-skills · skills/complete-task/SKILL.md · Complete an in-progress task by running clean-code, staging, and committing. Close the bead on trunk, leave it open for…
ciembor/agent-rules-books · clean-code/SKILL.md · Apply Robert C. Martin-inspired clean code rules when improving readability, naming, function design, responsibilities…
wondelai/skills · plugins/code-craftsmanship/skills/clean-code/SKILL.md · Write readable, maintainable code through disciplined naming, small functions, and clean error handling. Use when the…
wondelai/skills · clean-code/SKILL.md · Write readable, maintainable code through disciplined naming, small functions, and clean error handling. Use when the…
wondelai/skills · plugins/wondelai-skills/skills/clean-code/SKILL.md · Write readable, maintainable code through disciplined naming, small functions, and clean error handling. Use when the…
decebals/claude-code-java · skills/clean-code/SKILL.md · Clean Code principles (DRY, KISS, YAGNI), naming, function design and readability. Use when code is hard to read, with…
asymmetric-al/core · .agents/skills/clean-code/SKILL.md · Applies principles from Robert C. Martin's 'Clean Code'. Use this skill when writing, reviewing, or refactoring code to…
renky1025/agent-skills · clean-code/SKILL.md · Knowledge base distilled from "Clean Code: A Handbook of Agile Software Craftsmanship" by Robert C. Martin (Uncle Bob)…
