← ClaudeAtlas

explain-codelisted

Use when asked how X works or why it is so, to explain, teach or confirm it, if a stated reason holds even when a comment gives it, for a PR verdict, runbook, ADR or doc. Not for locations (exo:locate-code), libraries (check-docs), unproven failures (find-cause) or restructuring (audit-architecture).
blauwtje/exo · ★ 1 · AI & Automation · score 70
Install: claude install-skill blauwtje/exo
# Explain code Explain this repository from what was read in it this session, and say how sure each claim is. The enemy is the fluent answer built from a name, a comment, the asker's own theory or memory, which the user then acts on. The overcorrection is an answer so hedged or so long it decides nothing, or a list of locations where a narrative was asked. ## When to use - `how`: how something works, a walkthrough before a change, where a value really comes from. - `why`: why code is shaped this way, whether a stated reason holds, whether something can go. - `teach`: how plus why, pitched at the asker's level. - The skill changes no file; a change the answer leads to goes to the stage that owns it. - Not for locations only: the `exo:locate-code` agent returns those. - Not for how an external library or API behaves: `check-docs` owns it. - Not for behavior reported wrong with an unproven cause: `find-cause` owns it. - Not for where the architecture should change: `audit-architecture` owns it. ## The loop 1. **Name the mode and the question.** Write the question in one sentence and pick `how`, `why` or `teach`; a theory the asker brings is a hypothesis to test, never a finding. 2. **Read before you claim.** Every claim about behavior rests on a file and line opened this session, because a name, a comment or a recalled pattern can say the opposite of the code. 3. **Trace the whole chain.** Follow the path from entry to effect, including config, environment and call-site ove