simplify

Remove unnecessary abstractions from code while preserving public APIs.

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/nokusukun/sublime --skill simplify-nokusukun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: simplify
Source: https://github.com/nokusukun/sublime/tree/main/simplify
Command: npx skills add https://github.com/nokusukun/sublime --skill simplify-nokusukun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Strip speculative abstraction back to the smallest version that solves the problem today. Deletes factories, builders, strategies, single-use interfaces, and over-general generics that do not earn their keep. The diff is mostly deletions. Use when a module has grown factory cascades, preemptive interfaces, or seven-layer Clean Architecture for three tables.

Core Features & Use Cases

  • Remove unnecessary abstractions by inlining single-implementation interfaces, collapsing indirection, and eliminating rarely-used generics.
  • Reduce maintenance cost and diff noise, improving readability and review speed.
  • Use Case: when a module has expanded through factories and multiple layers, apply simplify to produce a lean, verifiable baseline that preserves behavior.

Quick Start

Identify the core behavior, inline non-essential abstractions, and produce a smaller, equivalent implementation for the target.

Frequently Asked Questions about simplify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove unnecessary abstractions from an over-engineered codebase?▼

To remove unnecessary abstractions, inline single-implementation interfaces, collapse factory call chains, and delete rarely-used generics. This produces a lean, maintainable module with smaller diffs while preserving the original public API and behavior.

What is the best way to refactor speculative code to improve maintainability?▼

Refactoring speculative code involves stripping preemptive interfaces and single-use builders back to the simplest working abstraction. This eliminates excessive indirection and reduces maintenance costs by delivering a verifiable baseline implementation.

Can I collapse factory cascades and multiple layers without breaking existing behavior?▼

Yes, you can collapse factory cascades and multiple architecture layers by inlining non-essential abstractions. The process ensures behavior remains unchanged by preserving public APIs and validating the leaner implementation through existing tests or checks.

When do I need to simplify over-abstracted architecture in my project?▼

You need to simplify over-abstracted architecture when a module exhibits factory cascades, preemptive interfaces, or excessive layers like seven-layer Clean Architecture for three tables. Simplifying reduces diff noise and improves code review speed.

How do I reduce diff noise from unused factories and single-use interfaces?▼

Reduce diff noise by deleting unused factories, builders, and single-use interfaces that do not earn their keep. Trimming speculative generics back to the smallest working version produces a smaller, equivalent implementation for the target module.

Does simplifying code architecture require external dependencies or components?▼

Simplifying code architecture does not require external dependencies or components. It operates directly on the target module to identify core behavior, inline non-essential abstractions, and produce a verifiable, equivalent implementation.