principle-minimize-reader-load

Reviews code to reduce indirection layers and hidden mutable state for readers.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/jeremybrasher/grokbot-skills --skill principle-minimize-reader-load-jeremybrasher
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: principle-minimize-reader-load
Source: https://github.com/jeremybrasher/grokbot-skills/tree/main/collections/pstack/skills/principle-minimize-reader-load
Command: npx skills add https://github.com/jeremybrasher/grokbot-skills --skill principle-minimize-reader-load-jeremybrasher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Code that is hard to trace forces readers to chase layers of indirection and hold hidden state in their heads. This Skill gives a concrete review method for measuring that reader load and cutting it with the smallest structural change. ## Core Features & Use Cases - Layer and state audit: Counts indirections between a question and its answer, and tracks how much mutable context a reader must hold. - Cut-first refactoring guidance: Collapses one-caller wrappers, pass-through adapters, and speculative abstractions; shrinks state scope from globals toward locals and pure functions. - Disciplined intake and HOLD rules: Refuses to apply the principle decoratively; stops and names missing inputs instead of guessing. - Use Case: During a code review of a service with six adapter layers and scattered module-level state, apply this Skill to identify which layers to inline and which state to derive, so a new reader can answer "where does X come from?" in under 30 seconds. ## Quick Start Review this module with the minimize-reader-load principle and tell me which wrappers to collapse and which state to shrink.

Frequently Asked Questions about principle-minimize-reader-load

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

FAQPage Schema
How do I reduce cognitive load in code reviews?▼

Count two things: layers of indirection between a question and its answer, and hidden mutable state the reader must track. Collapse one-caller wrappers and pass-through layers, then shrink state scope from globals toward locals and pure functions.

How to decide when to remove an abstraction layer?▼

Remove a layer when it costs more reader effort than it saves: wrappers with a single caller, adapters with no second implementation, or pass-through layers that repeat the same methods. A layer should compress complexity, not just rename it.

When should I not apply the minimize reader load principle?▼

Skip it when the trigger is not evidenced, when a narrower operational skill covers the same decision, or when citing it would not change any choice. The Skill explicitly HOLDs instead of applying the principle decoratively.

What is the difference between cyclomatic complexity and reader load?▼

Cyclomatic complexity counts branches; reader load measures the work a human does to trace code. A flat file with 50 globals can be harder to reason about than a layered design, so this Skill tracks indirection depth and state scope instead.

Why does this Skill sometimes return a HOLD instead of an answer?▼

It returns a HOLD when required inputs are missing: no concrete situation object, no evidence the trigger fires, or a conflict with a stated user constraint. A HOLD names the gap rather than inventing inputs to keep moving.