code-simplification is agent-read markdown (skill) from jpeetz/agent-skills: 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..
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
# 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
…
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.
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 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.
jpeetz/agent-skills · skills/api-backend/har-api-reverse-engineering/SKILL.md · Use this skill when an agent needs to call a website's hidden or undocumented API: capture real browser requests into a…
jpeetz/agent-skills · skills/api-backend/image-to-image-character-generation/SKILL.md · Use this skill when an agent needs to generate consistent character images via kie.ai grok-imagine image-to-image from…
jpeetz/agent-skills · skills/api-backend/social-har-api-connectivity/SKILL.md · Use this skill when an agent needs to connect to a social platform's API by prompting the user to pick a platform…
jpeetz/agent-skills · skills/business-strategy/app-discovery-scrutiny/SKILL.md · Use this skill when the user wants to evaluate a mobile app idea for commercial viability — whether it's a clone…
jpeetz/agent-skills · skills/business-strategy/enterprise-consulting-methods/SKILL.md · Use when you need McKinsey/BCG-grade strategy work — problem decomposition, hypothesis testing, storyline building…
jpeetz/agent-skills · skills/code-quality/debugging-and-error-recovery/SKILL.md · Use this skill when tests fail, builds break, runtime behavior doesn't match expectations, a bug report arrives, or…
addyosmani/agent-skills · skills/code-simplification/SKILL.md · Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but…
mohitagw15856/pm-claude-skills · exports/openclaw/code-simplification/SKILL.md · Simplify code that works — remove speculative abstraction, dead flexibility, and needless indirection while keeping…
blackbelttechnology/pi-agent-dashboard · packages/eng-disciplines/.pi/skills/code-simplification/SKILL.md · Active simplify pass for working code. Use when explicitly asked to "simplify this", "reduce complexity", "clean this…
shashankswe2020-ux/whoop-mcp · .github/skills/code-simplification/SKILL.md · Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-codex/.agents/skills/code-simplification/SKILL.md · Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-cursor/.cursor/skills/code-simplification/SKILL.md · Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/cursor/.cursor/skills/code-simplification/SKILL.md · Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/codex/.agents/skills/code-simplification/SKILL.md · Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but…
