code-simplification SKILL.md skillA

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

mdr add jpeetz/agent-skills/code-simplification@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

jpeetz/agent-skills

Path

skills/code-quality/code-simplification/SKILL.md

Versions recorded

1

Latest version

v1.0.0, committed Sep 21, 2026

Size

12,294 bytes

Repository stars

16

License

none declared

Use this skill when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity — deep nesting, long functions, unclear names, duplication, or over-engineering.

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 Simplification

> Reduce complexity while preserving exact behavior. The goal is not fewer lines — it's code that is easier to read, understand, modify, and debug.

## Quick Reference

| When to apply | What to check | Key heuristic |
|---|---|---|
| After feature is done, tests pass | Implementation feels heavier than needed | "Would a new team member understand this faster?" |
| During code review | Readability or complexity flags | Each simplification must be a clear net improvement |
| When encountering deep nesting | Conditional complexity | Flatten with guard clauses, not by removing checks |
| When names are unclear | Variable, function, class names | A good name removes the need for a comment |
| After merging duplicated code | Logic repeated across files | Extract once, reference everywhere |
| When an abstraction seems unnecessary | Indirection that obscures the flow | YAGNI: remove it, re-add when needed |

## When to Use

Use this skill when:

- **After a feature is working and tests pass** — but the implementation feels heavier than it needs to be
- **During code review** — when readability or complexity issues are flagged
…

Read the whole file at its exact version.

How to install

mdr add jpeetz/agent-skills/code-simplification@sha256:a062c0b3a90aa383

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

Versions

The registry has recorded 1 version of this file, committed on Sep 21, 2026.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_wrk5znxqxedgxhmj
GET https://markdownregistry.com/api/v1/resolve?ref=jpeetz/agent-skills/code-simplification
GET https://markdownregistry.com/api/v1/blob/a062c0b3a90aa383263a915bf44ba72b4a585f9b7c1e1a84a063a40268e4fd2f

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 jpeetz/agent-skills

Every file in jpeetz/agent-skills

Other files named code-simplification

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