simplify
Use after tests pass and before code review - a portable quality pass that simplifies recently changed code while preserving behavior
How do I install this agent skill?
npx skills add https://github.com/strelov1/spec-driven-tdd --skill simplifyIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides guidelines for code simplification and quality improvement. It operates on local code changes and does not involve network activity, sensitive data access, or external dependencies.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
simplify
A portable quality pass. Refine recently modified code for clarity, consistency, and maintainability without changing behavior. Quality only — this does not hunt for bugs (that is the review step).
Adapted from the code-simplifier agent; works on any harness.
Principles
- Preserve functionality — change how the code does it, never what it does. All outputs and behaviors stay identical.
- Apply project standards — read the project's context file (
CLAUDE.md/AGENTS.md/GEMINI.md) and follow its conventions, instead of imposing any fixed style. - Enhance clarity — reduce unnecessary nesting and complexity, remove redundant code and dead abstractions, improve names, consolidate related logic, drop comments that merely restate the code. Avoid nested ternaries — prefer if/else or switch. Explicit beats clever.
- Maintain balance — do not over-simplify in ways that hurt readability, debuggability, or extension. Do not collapse separate concerns into one unit. Never trade readability for fewer lines.
- Focus scope — only code touched in the current task, unless told to widen.
Process
- Identify the code changed in this task.
- Apply the refinements above.
- Re-run the tests — they MUST stay green. If any fail, you changed behavior; revert that refinement.
- Hand the cleaned diff to the review step.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/strelov1/spec-driven-tdd/simplify">View simplify on skillZs</a>