simplifying-code SKILL.md skillA

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

Install it, pinned
mdr add iliaal/ai-skills/simplifying-code@git:20261031.aee700a

Pins git:20261031.aee700a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
iliaal/ai-skills
Path
skills/simplifying-code/SKILL.md
Versions recorded
11
Latest version
git:20261031.aee700a, committed Oct 31, 2026
First version recorded
Jun 1, 2026
Size
9,152 bytes
Repository stars
45
License
MIT

Simplifies, polishes, and declutters code without changing behavior. Use when asked to simplify, clean up, refactor, declutter, remove dead code or AI slop, or improve readability, including analysis-only simplification reports and code pasted inline.

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

# Simplifying Code

## Working rules

- Preserve behavior, interfaces, side effects, and domain intent; prove any unshipped-shape exception has no consumers outside scope.
- Before removing a guard for an external hazard, reproduce its precondition and show the hazard is handled; otherwise retain it.
- Verify standard-library substitutions on empty, null, no-match, ordering, and zero-value cases.
- For analysis-only requests, identify targets and report proposed simplifications without editing code.

## Principles

| Principle | Rule |
|-----------|------|
| **Preserve behavior** | Output must do exactly what the input did, with no silent feature additions or removals. Specifically preserve: async/sync boundaries (do not convert sync to async or reverse), error propagation paths (do not alter strategy), logging/telemetry/guards/retries that encode operational intent, and domain-specific steps (do not collapse into generic helpers that hide intent). One carve-out: a shape that existed only in an earlier iteration of the current unshipped scope is not protected behavior. Verify it has no deployed, persisted, public, external, dependent-branch, or in-repo caller outside the resolved…
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add iliaal/ai-skills/simplifying-code@sha256:7bb49b4300d017b0

The line at the top of this page pins the label git:20261031.aee700a, 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_rdaxtbanvf75bnni.svg)](https://markdownregistry.com/a/art_rdaxtbanvf75bnni)

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

Versions

The registry has recorded 11 versions of this file, between Jun 1, 2026 and Oct 31, 2026, about one every 15 days.

versioncommittedcommitsizeaudit
git:20261031.aee700a latest2026-10-31 aee700a 9,152 BA view · diff
git:20261011.09c16df2026-10-11 09c16df 8,998 BA view · diff
git:20261003.39b82ef2026-10-03 39b82ef 8,198 BA view · diff
git:20260926.7b0520a2026-09-26 7b0520a 7,725 BA view · diff
git:20260918.0754cc32026-09-18 0754cc3 7,691 BA view · diff
git:20260913.76ac4e82026-09-13 76ac4e8 7,696 BA view · diff
git:20260908.6c9fed12026-09-08 6c9fed1 7,491 BA view · diff
git:20260804.30e97152026-08-04 30e9715 11,924 BA view · diff
git:20260718.80733c42026-07-18 80733c4 9,948 BA view · diff
git:20260620.b0325d62026-06-20 b0325d6 8,964 BA view · diff
git:20260601.e2aad932026-06-01 e2aad93 8,888 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 (9152 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

iliaal/ai-skills · 45 stars · license MIT · pushed 2026-10-31 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_rdaxtbanvf75bnni
GET https://markdownregistry.com/api/v1/resolve?ref=iliaal/ai-skills/simplifying-code
GET https://markdownregistry.com/api/v1/blob/7bb49b4300d017b050dc7297580c0535e4d13c0c1916ccfe941342c35d338ad1

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 iliaal/ai-skills

agent-native-architecture SKILL.md skill
iliaal/ai-skills · skills/agent-native-architecture/SKILL.md · Design agent-native applications where agents replace UI users as the primary actor. Use when designing MCP tools…
git:20261011.09c16df · audit A · 45 stars
brainstorming SKILL.md skill
iliaal/ai-skills · skills/brainstorming/SKILL.md · Pre-implementation exploration: deep interview, approach comparison, design doc. Use when exploring a vague feature…
git:20261019.5dcf8a9 · audit A · 45 stars
c-systems SKILL.md skill
iliaal/ai-skills · skills/c-systems/SKILL.md · C patterns for systems code, libraries, and native extensions: module layout, function decomposition, status-enum…
git:20261011.09c16df · audit A · 45 stars
code-review SKILL.md skill
iliaal/ai-skills · skills/code-review/SKILL.md · Structured code reviews with severity-ranked findings and deep multi-agent mode. Use when performing a code review…
git:20261011.09c16df · audit A · 45 stars
cpp-systems SKILL.md skill
iliaal/ai-skills · skills/cpp-systems/SKILL.md · Modern C++ patterns: RAII and ownership, rule of zero/five, exceptions and error handling, API and ABI boundaries…
git:20261011.09c16df · audit A · 45 stars
debugging SKILL.md skill
iliaal/ai-skills · skills/debugging/SKILL.md · Systematic root-cause debugging with verification. Use for errors, stack traces, broken tests, flaky tests…
git:20260926.7b0520a · audit A · 45 stars
document-review SKILL.md skill
iliaal/ai-skills · skills/document-review/SKILL.md · Structural and accuracy review of documents: gaps, clarity, completeness, organization, and claims checked against the…
git:20261003.39b82ef · audit A · 45 stars
frontend-design SKILL.md skill
iliaal/ai-skills · skills/frontend-design/SKILL.md · Visual design and aesthetic direction for frontend interfaces. Use when building web pages, landing pages, dashboards…
git:20261011.09c16df · audit A · 45 stars
git-worktree SKILL.md skill
iliaal/ai-skills · skills/git-worktree/SKILL.md · Manage Git worktrees for isolated parallel development. Use when creating, listing, switching, or cleaning up git…
git:20261025.051b42b · audit A · 45 stars
linux-bash-scripting SKILL.md skill
iliaal/ai-skills · skills/linux-bash-scripting/SKILL.md · Defensive Bash scripting for Linux: safe foundations, argument parsing, production patterns, ShellCheck compliance. Use…
git:20261011.09c16df · audit A · 45 stars
md-docs SKILL.md skill
iliaal/ai-skills · skills/md-docs/SKILL.md · Manages project documentation: CLAUDE.md, AGENTS.md, README.md, CONTRIBUTING.md, DOCS.md. Use when asked to update…
git:20261003.39b82ef · audit A · 45 stars
meta-prompting SKILL.md skill
iliaal/ai-skills · skills/meta-prompting/SKILL.md · Structured decision modifiers (/think, /verify, /adversarial, /edge, /confidence, /assumptions, etc.) to stress-test…
git:20260926.7b0520a · audit A · 45 stars

Every file in iliaal/ai-skills

Other files named simplifying-code

simplifying-code SKILL.md skill
iliaal/whetstone · distillery/generated-skills/simplifying-code/SKILL.md · Simplifies, polishes, and declutters code without changing behavior. Use when asked to "simplify code", "clean up…
git:20260227.215f429 · audit A · 35 stars

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