skills.rest
phrazzld
phrazzldCOMMUNITY
Explore all skills by this author →
GitHub

simplify

Identify and implement the most impactful codebase simplification in a single pull request.

13|3|Updated Mar 2, 2026
Search Tags:#code quality#architecture#maintainability#refactor#simplification#first principles
One-click install
npx skills add https://github.com/phrazzld/agent-skills --skill simplify-phrazzld
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: simplify
Source: https://github.com/phrazzld/agent-skills/tree/main/core/simplify
Command: npx skills add https://github.com/phrazzld/agent-skills --skill simplify-phrazzld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill tackles the challenge of reducing codebase complexity by identifying and implementing the most impactful simplification within a single pull request.

Core Features & Use Cases

  • Strategic Refactoring: Identifies and executes high-leverage simplifications in architecture or code.
  • First-Principles Redesign: Encourages rethinking systems as if building them today, not based on historical constraints.
  • Use Case: When a system has become unwieldy and difficult to maintain, this Skill can be used to find the single best change that makes it significantly cleaner and easier to work with, fitting within one PR.

Quick Start

Use the simplify skill to find the highest-leverage simplification in the current repository.

Frequently Asked Questions about simplify

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

FAQPage Schema
How do I find the most impactful refactoring to simplify a complex codebase?▼

First-principles reasoning simplifies code by rethinking systems as if building them today, discarding outdated design patterns and historical constraints. It applies Ousterhout-style module depth to execute strategic refactoring that significantly improves maintainability.

What is the best way to reduce architectural complexity without breaking existing tests?▼

Reduce architectural complexity by proposing a verifiable, low-risk refactor that addresses code duplication and outdated patterns. Analyzing tests and git history ensures the simplification maintains system integrity while fitting within a single pull request.

Can I refactor a large unwieldy system if the changes fit within a single pull request?▼

Yes, you can refactor an unwieldy system if the simplification fits within a single pull request. The process identifies the single best change to make the architecture cleaner and easier to maintain, ensuring the scope remains manageable and verifiable.

When should I avoid using first-principles redesign for code maintainability?▼

Avoid first-principles redesign when a codebase requires multiple pull requests to address complexity, or when high-risk changes cannot be verified by existing tests. This approach targets single, low-impact simplifications rather than sweeping architectural overhauls.

Related Skills

Explore More Software Engineering Skills→
pradeepmoulipradeepmouli
2

speckit-workflows.baseline

Execute a script to generate baseline-spec.md and current-state.md from JSON output.

Community
Advanced
mouratomourato

git-workflow

Manage Git branches, atomic commits, and pull request preparation.

Community
Intermediate
TheFJKTheFJK
2

uberdev-cmd-ubersimplify

Automate whole-repo code simplification with multi-lens area-based optimization.

Community
Advanced
cacr92cacr92
4

refactoring

Refactor Rust and React code to improve maintainability and test coverage.

Community
Intermediate