reduce

Audits codebase abstractions and proposes prioritized cuts with a migration plan.

66|2|Updated Feb 18, 2015
One-click install
npx skills add https://github.com/tkersey/dotfiles --skill reduce
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reduce
Source: https://github.com/tkersey/dotfiles/tree/main/codex/skills/reduce
Command: npx skills add https://github.com/tkersey/dotfiles --skill reduce

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deconstructs high-cost abstractions that coding agents do not need; recommend lower-level primitives that reduce tools, indirection, and hidden steps. Default output is an abstraction audit + prioritized cut list + migration plan + minimal-incision patch suggestions (no implementation unless explicitly requested).

Core Features & Use Cases

  • Abstraction audit: identify indirection points across toolchains, frameworks, and configurations.
  • Prioritized cuts: score abstractions and propose delete/slice/replace plans with clear migration steps.
  • Migration planning: provide phased, reversible steps with rollback considerations for safe transitions.

Quick Start

Use the reduce skill to generate an abstraction audit and actionable cut list for the current repository, then review the proposed patches.

Frequently Asked Questions about reduce

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

FAQPage Schema
How do I audit abstraction cost versus value in my codebase?

An abstraction audit identifies indirection points across toolchains, frameworks, and configurations to evaluate their cost versus value. It uses repo-local evidence scoring and a three-score rubric to pinpoint detours caused by unnecessary tooling or hidden steps in your codebase.

What is the best way to plan a migration away from high-cost framework abstractions?

The best way to plan a migration from high-cost framework abstractions is to generate a prioritized cut list and phased migration plan. This provides reversible steps with rollback considerations, proposing lower-level primitives to replace complex tooling safely without implementing changes unless explicitly requested.

When do I need to de-abstract tooling in my software project?

You need to de-abstract tooling when coding agents encounter high-cost abstractions they do not need. If your project suffers from excessive indirection, hidden steps, or framework complexity that overrides repo-local evidence, an abstraction audit can identify and propose lower-level primitives to reduce that complexity.

Can I get patch suggestions for cutting complexity without automatically implementing changes?

Yes, you can receive minimal-incision patch suggestions without automatically implementing changes. The reduce process generates an abstraction audit, prioritized cut list, and migration plan with deterministic patches, but it strictly satisfies a no-implementation constraint unless you explicitly request the changes.

Does the abstraction cut list support rollback considerations for safe transitions?

Yes, the abstraction cut list supports rollback considerations for safe transitions. The migration planning feature provides phased, reversible steps to ensure you can safely transition to lower-level primitives while mitigating risks associated with removing tooling, frameworks, or indirection.