# Code Simplifier

> Reviews code for unnecessary complexity, excessive nesting, redundant abstractions, and over-engineering. Use when code feels over-engineered, before PRs, or after implementations. Complements code-reviewer (correctness) by focusing purely on simplicity and readability.

- **Type:** Skill
- **Install:** `agentstack add skill-kumaran-is-claude-code-onboarding-code-simplifier`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kumaran-is](https://agentstack.voostack.com/s/kumaran-is)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kumaran-is](https://github.com/kumaran-is)
- **Source:** https://github.com/kumaran-is/claude-code-onboarding/tree/develop/.claude/skills/code-simplifier

## Install

```sh
agentstack add skill-kumaran-is-claude-code-onboarding-code-simplifier
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

**Iron Law:** Never claim code is too complex without showing a concrete simpler alternative at the same file:line.

# Code Simplifier

Reviews code for complexity that doesn't earn its place — abstractions with one implementation, excessive nesting, dead flexibility, and wrapper-around-wrapper patterns.

## When to Use

- Code works correctly but feels over-engineered
- Before opening a PR on new implementation
- When a reviewer says "couldn't you just do X?"
- After implementing a feature that grew beyond its original scope

## What to Check

| Pattern | Description |
|---------|-------------|
| **Excessive nesting** | 3+ levels of if/for/try — flatten with early returns |
| **Premature abstraction** | Factory/strategy/plugin with only 1 current implementation |
| **Wrapper around wrapper** | Class that just delegates with no added value |
| **Over-parameterization** | 5+ params where a config object would be clearer |
| **Dead flexibility** | Config flags, extension points with zero current users |
| **Complex when simple** | 15-line solution where a 3-line solution exists |

## Severity Levels

| Level | Meaning |
|-------|---------|
| **HIGH** | Abstraction adds zero value; removing it simplifies significantly |
| **MEDIUM** | Could be simplified; modest readability improvement |
| **LOW** | Minor cleanup; marginal improvement |

## Output Format

```
## Simplification Review: [scope]

### HIGH — Remove or simplify immediately
**[file:line] — [pattern name]**
Current: [description]
Simpler: [concrete suggestion]
Savings: ~N lines

### MEDIUM — Should simplify
- [file:line] [description] — [suggestion]

### Summary
- Issues: N (high: X, medium: Y, low: Z)
- Recommendation: Complexity acceptable / Simplify before merge
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kumaran-is](https://github.com/kumaran-is)
- **Source:** [kumaran-is/claude-code-onboarding](https://github.com/kumaran-is/claude-code-onboarding)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-kumaran-is-claude-code-onboarding-code-simplifier
- Seller: https://agentstack.voostack.com/s/kumaran-is
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.