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.