explain-code

Installation
SKILL.md

Explain Code

Workflow

  1. Start with an analogy — compare the code to something from everyday life
  2. Pick the right C4 level — match diagram depth to the question; default Level 2 (Container)
  3. Draw the diagram — render it as an ASCII box diagram directly in the response (no external tooling). Pick the C4 level per step 2, then build boxes/arrows with plain characters (+ - | v ^ <- ->), keeping lines within ~80 columns so it stays readable in a terminal or chat window. Label each box with the component name (and a one-line responsibility if it fits), and label arrows with the action or event that flows along them.
  4. Walk through the code — trace inputs to outputs in narrative form: what enters, which functions/modules touch it in order, where state changes, what exits. Name the data, not just the steps.
  5. Highlight a gotcha — what's a common mistake or misconception?

Keep explanations conversational. For complex concepts, use multiple analogies.

Example output shapes

Single function

Installs
122
Repository
bsene/skills
GitHub Stars
5
First Seen
Apr 12, 2026
explain-code — bsene/skills