Simplify code that works — remove speculative abstraction, dead flexibility, and needless indirection while keeping behaviour identical and verified. Use after a feature lands ('now simplify it'), when AI-generated code arrives over-engineered, when a file has grown hard to follow, or as the cleanup pass before review. Produces a smaller, flatter version with identical behaviour, plus a ledger of what was removed and why it was safe. For finding bugs use code-review-checklist / ai-code-review…
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 Skill
Code accretes defensive complexity: abstractions for futures that never came, options nobody passes, indirection that once had a reason. AI-generated code arrives pre-accreted — interfaces with one implementer, config objects with nine unused knobs. Simplification is its own pass with its own rule: **behaviour identical, verified; complexity removed, listed.**
## What This Skill Produces
- The simplified code — smaller, flatter, same behaviour
- A **removal ledger**: each simplification, why it was safe, and what future it forecloses (honestly)
- Verification evidence that behaviour held
## Required Inputs
Ask for these if not provided:
- **The code** — what works today and should keep working
- **The pressure** — what made it feel complex: onboarding, a bug, a review comment
- **What must not change** — the public API, behaviour, or performance envelope
- **Test coverage** — whether there are tests to prove the simplification is safe
## What to Hunt (in order of payoff)
…
The line at the top of this page pins the label git:20260821.f4e8863, 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.
GET https://markdownregistry.com/api/v1/artifacts/art_qa7re636k46s3qax
GET https://markdownregistry.com/api/v1/resolve?ref=mohitagw15856/pm-claude-skills/code-simplification
GET https://markdownregistry.com/api/v1/blob/e34504cd97d7f7fea103d79c8bf222a9fcd72a3185d0c3b4afc333eb5e43a773
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.
mohitagw15856/pm-claude-skills · examples/promoter/drafted-skill/SKILL.md · Turn a git log into user-facing release notes grouped by feature and fix. Use when asked for release notes from this…
mohitagw15856/pm-claude-skills · exports/openclaw/360-feedback-template/SKILL.md · Design a 360-degree feedback survey or write a structured 360 feedback report. Use when asked to build a 360 feedback…
mohitagw15856/pm-claude-skills · exports/openclaw/401k-plan-decoder/SKILL.md · Decode a 401k or workplace retirement plan — the real cost of its funds, the match's fine print, vesting math, and the…
mohitagw15856/pm-claude-skills · exports/openclaw/ab-test-readout/SKILL.md · Analyse a finished A/B test and write the readout — the result, whether it's statistically and practically significant…
mohitagw15856/pm-claude-skills · exports/openclaw/academic-cv/SKILL.md · Build or tailor an academic CV for faculty, postdoc, research or fellowship applications: publications, grants…
mohitagw15856/pm-claude-skills · exports/openclaw/accessibility-audit/SKILL.md · Generate a WCAG 2.2 accessibility audit checklist and remediation suggestions for any UI or design. Use when asked to…
mohitagw15856/pm-claude-skills · exports/openclaw/accessible-travel-planner/SKILL.md · Plan a trip that actually works with a disability or access need — confirm real accessibility (not just 'accessible'…
mohitagw15856/pm-claude-skills · exports/openclaw/accommodation-request/SKILL.md · Request a reasonable accommodation at work or in education — frame it around the barrier and the adjustment (not your…
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…
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…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/skills/code-simplification/SKILL.md · Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but…