simplify SKILL.md skillA

simplify from ronaknnathani/relay is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ronaknnathani/relay/simplify@git:20261019.02f6f4f

Pins git:20261019.02f6f4f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ronaknnathani/relay
Path
skills/simplify/SKILL.md
Versions recorded
3
Latest version
git:20261019.02f6f4f, committed Oct 19, 2026
First version recorded
Jun 29, 2026
Size
6,098 bytes
Repository stars
43
License
MIT

Reduce complexity in recently changed code — cut needless abstraction, dead code, and duplication; improve names and structure — WITHOUT changing behavior. Quality only; it does not hunt for bugs (use review for that). Use after implementing a chunk of work, before review, or whenever a diff feels more complicated than the problem it solves. Triggers on "clean this up" / "tidy this" / "refactor this" when code already exists; for an underspecified goal with no code yet, use `clarify`.

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

# Simplify

Make a change simpler and clearer without changing what it does. The bar: readable, explicit code over
clever, compact code — would a senior engineer call this overcomplicated? Scope is the **recently
changed code** — the working diff (e.g. `git diff` against the branch point) unless the caller names
files. This is quality-only: it does not hunt for bugs (that's `review`).

## Step 0 — the invariant

**Preserve functionality. Never change what the code does, only how it does it.** Every original
feature, output, and behavior stays intact. If a simplification would alter behavior, it is a `review`
or implementation concern, not a simplification — stop and surface it.

## Scan — three buckets

Look at the changed code for:

- **Structural** — nesting depth ≥ 3, functions longer than ~50 lines, nested ternaries, boolean-flag
  parameters that select behavior, indirection that only forwards a call.
- **Naming** — `data`/`result`/`temp`/`foo`, names that mislead, names that imply something broader or
  different than the thing actually is.
- **Redundancy** — duplicated logic, dead/unreachable code, unused parameters/variables/fields,
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ronaknnathani/relay/simplify@sha256:1f252c306954bf71

The line at the top of this page pins the label git:20261019.02f6f4f, 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_nemqa5fbjxlj5trj.svg)](https://markdownregistry.com/a/art_nemqa5fbjxlj5trj)

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

Versions

The registry has recorded 3 versions of this file, between Jun 29, 2026 and Oct 19, 2026, about one every 56 days.

versioncommittedcommitsizeaudit
git:20261019.02f6f4f latest2026-10-19 02f6f4f 6,098 BA view · diff
git:20260629.73803102026-06-29 7380310 5,588 BA view · diff
git:20260629.63b0fec2026-06-29 63b0fec 5,442 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 (6098 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

ronaknnathani/relay · 43 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_nemqa5fbjxlj5trj
GET https://markdownregistry.com/api/v1/resolve?ref=ronaknnathani/relay/simplify
GET https://markdownregistry.com/api/v1/blob/1f252c306954bf718eabec167e82bcf0df15d53b306360ad74282be89977ee27

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 ronaknnathani/relay

build-write-like-me SKILL.md skill
ronaknnathani/relay · skills/build-write-like-me/SKILL.md · Use this skill whenever the user wants to capture, clone, or codify their own (or someone's) writing voice into a…
git:20260811.a9d417f · audit A · 43 stars
clarify SKILL.md skill
ronaknnathani/relay · skills/clarify/SKILL.md · Turn a vague or underspecified task into a crisp requirements + testable acceptance-criteria document by closing the…
git:20260629.7380310 · audit A · 43 stars
commit SKILL.md skill
ronaknnathani/relay · skills/commit/SKILL.md · Create a single well-formed git commit from the working changes, following the repo's AGENTS.md and recent…
git:20260703.d975737 · audit A · 43 stars
deliver-pr SKILL.md skill
ronaknnathani/relay · skills/deliver-pr/SKILL.md · Deliver one change end to end as a single pull request — clarify → plan → implement → simplify → review → validate →…
git:20260902.0a12af0 · audit A · 43 stars
explore SKILL.md skill
ronaknnathani/relay · skills/explore/SKILL.md · Build a verified, read-only understanding of a codebase or a slice of it — entry points, code flow, architecture…
git:20260629.a497d9d · audit A · 43 stars
implement SKILL.md skill
ronaknnathani/relay · skills/implement/SKILL.md · Execute an implementation plan (from `plan`) task by task, writing the code and tests and leaving the system green at…
git:20260703.d975737 · audit A · 43 stars
open-pr SKILL.md skill
ronaknnathani/relay · skills/open-pr/SKILL.md · Stage, commit, push, and open a pull request following the author's repository and AGENTS.md conventions — repo-style…
git:20260703.d975737 · audit A · 43 stars
plan SKILL.md skill
ronaknnathani/relay · skills/plan/SKILL.md · Turn a clarified requirements artifact into a concrete, executable implementation plan — a decisive architecture…
git:20260629.7380310 · audit A · 43 stars
pr-fix SKILL.md skill
ronaknnathani/relay · skills/pr-fix/SKILL.md · Bring a PR to mergeable — fix CI failures, address review comments, and resolve merge conflicts. Runs either from a…
git:20260924.f980c5b · audit A · 43 stars
pr-monitor SKILL.md skill
ronaknnathani/relay · skills/pr-monitor/SKILL.md · Handle one pull request attention event end to end — read the watcher digest, triage it, delegate the fixing to pr-fix…
git:20260902.6e57c00 · audit A · 43 stars
rebase SKILL.md skill
ronaknnathani/relay · skills/rebase/SKILL.md · Use when you need to rebase the current branch onto main, resolve merge conflicts, and force-push
git:20260629.9a6d3b4 · audit A · 43 stars
relay-archive SKILL.md skill
ronaknnathani/relay · skills/relay-archive/SKILL.md · Use when a project's PR is merged and you want to clean up the worktree while preserving notes and plans
git:20260630.3bc1f89 · audit A · 43 stars

Every file in ronaknnathani/relay

Other files named simplify

simplify SKILL.md skill
qwenlm/qwen-code · packages/core/src/skills/bundled/simplify/SKILL.md · Review recent code changes for reuse, code quality, and efficiency, then directly apply straightforward cleanup…
git:20260718.d4db5fc · audit A · 29,081 stars
simplify SKILL.md skill
fcakyon/claude-codex-settings · plugins/simplify/skills/simplify/SKILL.md · This skill should be used when the user asks to "simplify", "clean up the diff", "run simplify", "simplify the…
git:20261107.0574bbb · audit A · 1,200 stars
simplify SKILL.md skill
cowork-os/cowork-os · resources/skills/simplify/SKILL.md · Improve existing work with focused simplification passes across code, writing, research, operations, or general tasks.
v1.0.0 · audit A · 535 stars
simplify SKILL.md skill
sd0xdev/sd0x-harness · skills/simplify/SKILL.md · Wrap-up refactoring — simplify code, eliminate duplication, preserve behavior
git:20260404.1c6641c · audit A · 194 stars
simplify SKILL.md skill
genai-io/san · .san/personas/software-engineer/skills/simplify/SKILL.md · Review changed code for reuse, quality, and efficiency, then clean up what you find — duplicated logic that could reuse…
git:20260717.120e9bb · audit A · 147 stars
simplify SKILL.md skill
haacked/dotfiles · ai/codex/skills/simplify/SKILL.md · Simplify recently changed code for clarity, consistency, and maintainability while preserving behavior. Use after…
git:20260827.f7bfa75 · audit A · 133 stars
simplify SKILL.md skill
sneg55/agent-starter · skills/simplify/SKILL.md · Review changed code for reuse, quality, and efficiency, then fix any issues found.
git:20260615.d335473 · audit A · 74 stars
simplify SKILL.md skill
maquina-app/rails-claude-code · rails-simplifier/skills/simplify/SKILL.md · Simplifies and refines Ruby on Rails code following 37signals patterns and the One Person Framework philosophy, while…
git:20260714.12902ab · audit A · 48 stars

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