← ClaudeAtlas

readable-codelisted

Language-agnostic local-clarity craft -- shape control flow, the naming of a whole set, and reading order so a body reads straight down with the smallest working set. Sibling to code-hygiene, comment-hygiene and code-structure.
Jartan-LLC/grimoire · ★ 2 · AI & Automation · score 71
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