awesome-code-cleanup SKILL.md skillA

awesome-code-cleanup from khasky/awesome-agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add khasky/awesome-agent-skills/awesome-code-cleanup@git:20261020.58ea4e8

Pins git:20261020.58ea4e8 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
khasky/awesome-agent-skills
Path
skills/awesome-code-cleanup/SKILL.md
Versions recorded
19
Latest version
git:20261020.58ea4e8, committed Oct 20, 2026
First version recorded
Aug 28, 2026
Size
34,825 bytes
Repository stars
30
License
MIT

Behavior-preserving cleanup of AI-like code noise: narrating comments, dead code, vague names, over-abstraction. Use when asked to clean up code or comments, de-slop, or apply a slop-audit report.

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

# Code Cleanup

Audit and clean every code comment in a repository (or a scoped part of it) so the code follows: comments only when strictly necessary; the code itself is authoritative and self-documenting; kept comments are 1–2 lines where possible. The pass is strictly behavior-preserving — a comment pass that changes behavior is a failed pass.

Every comment gets one of four verdicts:

| Verdict | When | Action |
|---|---|---|
| DELETE | Restates code, narrates flow, tutorial-style, echoes a signature | Remove |
| CONDENSE | Load-bearing but bloated | Compress to 1–2 lines, keep the essence |
| FIX | Stale, misplaced, or contradicts the code | Verify against code, rewrite accurately (or delete) |
| KEEP | Dense gotcha/contract that genuinely needs its length | Leave intact, flag in report |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add khasky/awesome-agent-skills/awesome-code-cleanup@sha256:9a49ae867c8f5edd

The line at the top of this page pins the label git:20261020.58ea4e8, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 19 versions of this file, between Aug 28, 2026 and Oct 20, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20261020.58ea4e8 latest2026-10-20 58ea4e8 34,825 BA view · diff
git:20261019.a19c2a52026-10-19 a19c2a5 35,541 BA view · diff
git:20261018.a4259a52026-10-18 a4259a5 35,662 BA view · diff
git:20261010.3b37a6b2026-10-10 3b37a6b 35,667 BA view · diff
git:20261010.d6650102026-10-10 d665010 34,721 BA view · diff
git:20260925.eca990b2026-09-25 eca990b 33,782 BA view · diff
git:20260925.d8504402026-09-25 d850440 33,976 BA view · diff
git:20260922.c0300702026-09-22 c030070 34,367 BA view · diff
git:20260918.de12e6b2026-09-18 de12e6b 30,975 BA view · diff
git:20260918.73a74652026-09-18 73a7465 30,985 BA view · diff
git:20260918.35adc9c2026-09-18 35adc9c 30,387 BA view · diff
git:20260912.e5449eb2026-09-12 e5449eb 28,565 BA view · diff
git:20260910.ad72ad42026-09-10 ad72ad4 28,061 BA view · diff
git:20260908.9485d682026-09-08 9485d68 28,301 BA view · diff
git:20260905.169ee222026-09-05 169ee22 27,814 BA view · diff
git:20260903.63971582026-09-03 6397158 26,902 BA view · diff
git:20260903.c5055512026-09-03 c505551 27,452 BA view · diff
git:20260831.2b780d42026-08-31 2b780d4 23,376 BA view · diff
git:20260828.a07c33e2026-08-28 a07c33e 22,826 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the 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 (34825 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

khasky/awesome-agent-skills · 30 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zd6negkqgufrc2da
GET https://markdownregistry.com/api/v1/resolve?ref=khasky/awesome-agent-skills/awesome-code-cleanup
GET https://markdownregistry.com/api/v1/blob/9a49ae867c8f5edd7a41d7b36470d19f5e1caf47ae1970a4538662dcdd0d84a3

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 khasky/awesome-agent-skills

AGENTS.md AGENTS.md file
khasky/awesome-agent-skills · AGENTS.md
git:20261018.a4259a5 · audit A · 30 stars
CLAUDE.md CLAUDE.md file
khasky/awesome-agent-skills · CLAUDE.md
git:20260912.c0b82df · audit B · 30 stars
llms.txt llms.txt file
khasky/awesome-agent-skills · llms.txt
git:20261010.3b37a6b · audit A · 30 stars
awesome-accessibility-audit SKILL.md skill
khasky/awesome-agent-skills · skills/awesome-accessibility-audit/SKILL.md · Read-only WCAG audit of UI and markup with a concrete fix per finding. Use when asked to check accessibility, a11y…
git:20261020.58ea4e8 · audit A · 30 stars
awesome-agents-md-generator SKILL.md skill
khasky/awesome-agent-skills · skills/awesome-agents-md-generator/SKILL.md · Mines a codebase's real commands, conventions and boundaries into an agent-agnostic AGENTS.md, nested per package in…
git:20261018.a4259a5 · audit A · 30 stars
awesome-api-design SKILL.md skill
khasky/awesome-agent-skills · skills/awesome-api-design/SKILL.md · Designs or reviews an HTTP API's shape before code: resources, versioning, pagination, idempotency, filtering. Use when…
git:20261018.a4259a5 · audit A · 30 stars
awesome-architecture-audit SKILL.md skill
khasky/awesome-agent-skills · skills/awesome-architecture-audit/SKILL.md · Read-only audit of a whole codebase's design: module boundaries, dependency direction, docs-vs-code drift…
git:20261019.a19c2a5 · audit B · 30 stars
awesome-bug-fix SKILL.md skill
khasky/awesome-agent-skills · skills/awesome-bug-fix/SKILL.md · Fixes a bug through a runnable reproduction and its root cause. Use for errors, crashes, failing tests or builds, flaky…
git:20261020.58ea4e8 · audit A · 30 stars
awesome-claims-audit SKILL.md skill
khasky/awesome-agent-skills · skills/awesome-claims-audit/SKILL.md · Checks public claims (site, README, store listing, privacy policy, structured data) against the code and config that…
git:20261019.a19c2a5 · audit A · 30 stars
awesome-code-docs SKILL.md skill
khasky/awesome-agent-skills · skills/awesome-code-docs/SKILL.md · Generates a full, cited technical documentation set for a codebase, local or from any git URL: architecture, module and…
git:20261018.a4259a5 · audit A · 30 stars
awesome-code-explainer SKILL.md skill
khasky/awesome-agent-skills · skills/awesome-code-explainer/SKILL.md · Explains how a codebase works, local or from any git URL, as one illustrated page: purpose, stack, structure, entry…
git:20261018.a4259a5 · audit A · 30 stars
awesome-code-review-feedback SKILL.md skill
khasky/awesome-agent-skills · skills/awesome-code-review-feedback/SKILL.md · Handles review comments others left on the user's change: which points to apply, clarify or push back on, each checked…
git:20261020.58ea4e8 · audit A · 30 stars

Every file in khasky/awesome-agent-skills

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