Detect and simplify overly complex code. Apply KISS principle - less is more.
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
> **AI-consumed reference.** Optimized for Claude to read during execution.
> Human-readable explanation: see [docs/architecture/HIERARCHICAL_PLANNING.md](../../../docs/architecture/HIERARCHICAL_PLANNING.md)
> or [docs/getting-started/](../../../docs/getting-started/) depending on topic.
# Code Simplifier
KISS principle. Full guide: `rules/core/simplicity-over-complexity.md`
## Signals → Actions
```toon
signals[5]{signal,action}:
Deep nesting (>3 levels),Flatten with early returns
Long function (>30 lines),Extract smaller functions
Complex conditionals,Use lookup tables
Over-abstraction,Inline single-use code
Premature optimization,Remove unless profiled
```
## Targets
```toon
targets[5]{metric,max}:
Cyclomatic complexity,10
Nesting depth,3
Function length,30 lines
File length,300 lines
Parameters,3
```
## Before Writing Code Ask
1. Can I delete this? (unused code, dead branches)
2. Can I inline this? (single-use abstractions)
3. Can I flatten this? (nested conditions)
4. Can I use built-ins? (standard library)
5. Is this needed now? (YAGNI)
The line at the top of this page pins the label git:20261029.30f94d9, 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_xn3ztl4n4c6eiwo5
GET https://markdownregistry.com/api/v1/resolve?ref=nguyenthienthanh/aura-frog/code-simplifier
GET https://markdownregistry.com/api/v1/blob/1b15a4d856e9dac790167dc4f8e87896c48a66176a90fc79fc12128ad5d5ebe1
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.
nguyenthienthanh/aura-frog · archon-os/skills/agent-detector/SKILL.md · CRITICAL: MUST run for EVERY message. Detects agent, complexity, AND model automatically. Without this, tasks route to…
nguyenthienthanh/aura-frog · archon-os/skills/bugfix-quick/SKILL.md · Fast bug fixes with root cause investigation + TDD. Enforces 'no fix without root cause' discipline and verification…
nguyenthienthanh/aura-frog · archon-os/skills/code-map/SKILL.md · Reverse-dependency lookup — "I am about to change this file, what breaks?" Use when assessing the blast radius of an…
nguyenthienthanh/aura-frog · archon-os/skills/deep-debugging/SKILL.md · Systematic debugging protocol for bugs that resist quick fixes. Use bisection, hypothesis trees, and scientific method…
taskless/cli · .agents/skills/code-simplifier/SKILL.md · Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Use when…
openhands/extensions · skills/code-simplifier/SKILL.md · Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Analyzes…
aktsmm/agent-skills · code-simplifier/SKILL.md · Guide for simplifying and refining code after coding sessions. Use when cleaning up complex code, reviewing PRs for…
yeisonrestrepo/code-conductor · skills/code-simplifier/SKILL.md · Always-active simplicity rules: no speculative abstractions, one job per function, max 30 lines, flat over nested with…
alamoooooooo/alamo_hub · packages/engineering_subagent_workflow_kernel/code-simplifier/SKILL.md · Simplify recently changed or explicitly scoped code while preserving observable behavior. Use when the user asks to…
alamoooooooo/alamo-skills · packages/engineering_subagent_workflow_kernel/code-simplifier/SKILL.md · Simplify recently changed or explicitly scoped code while preserving observable behavior. Use when the user asks to…
simonwong/skills · skills/engineering/code-simplifier/SKILL.md · Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Focuses…