readable-codelisted
Install: claude install-skill Jartan-LLC/grimoire
# Readable Code
The local-clarity sibling of `code-structure`. `code-structure` carves the units and their contracts; this skill shapes how a single body reads to a human once those units exist. Four owners, one test:
- **hygiene = DELETE** what git or a library already owns -- a restating comment, dead code, a name that lies or says nothing. A rule that says *delete X* is hygiene's.
- **readable-code = READ** -- shape control flow, the naming of a *set* of identifiers, and the order and locality of a body so a reader follows it straight down holding as little in mind as possible.
- **code-structure = SHAPE THE UNITS** -- decomposition and depth, cohesion, coupling, interfaces, contracts, data invariants. Anything about *where a seam falls* or *how big a unit should be* is `code-structure`'s (it owns the size-vs-depth resolution); this skill assumes the units are already carved and asks only whether each reads clearly.
- **pythonica = Python mechanics** -- a rule naming a Python construct (a comprehension, `match`, a context manager) is pythonica's; keep this skill language-agnostic.
Every rule below is a recognizable **smell** (something a reader or author can actually spot) -> the **principle** it violates -> a **fix** direction. No line or nesting-depth count gates any rule; that false precision is what these qualitative smells replace.
## Control-flow shape
The physical shape should mirror the logical shape.
- **Buried happy path** -- SMELL: you cannot find the main