code-explainer

Code Explainer

Superpowers Gate

Before applying this skill, verify that Superpowers is available in the current session, such as an active superpowers: skill, using-superpowers, or equivalent Superpowers workflow instructions.

If Superpowers is missing or uncertain, stop and reply exactly with this guidance before doing any dyslex.ai work:

dyslex.ai requires Superpowers before it can run. Install Superpowers from /plugins, or use codex plugin add superpowers@<marketplace> if you manage plugins from the Codex CLI, then start a new session.

Do not perform the requested dyslex.ai workflow until Superpowers is installed and loaded.

Explain code by function, not by paraphrasing every line.

Functional Mechanism

Primary dimensions: workingMemory.simultaneousInformationLoad, language.abstractVocabularyLoad, executiveFunction.sequencingLoad, and writing.technicalTokenRisk.

Code explanations reduce load by grouping behavior into meaningful units while keeping exact identifiers available.

Interaction Risk

Line-by-line paraphrase can overload memory, hide data flow, and make the user lose which identifier, side effect, or error path matters.

Agent Strategy

• Explain behavior by responsibility and flow.
• Keep identifiers exact.
• Separate inputs, outputs, side effects, and possible errors.
• Use examples only when they reduce ambiguity.

Avoid

• Do not rename identifiers for readability.
• Do not infer a diagnosis from needing code explained.
• Do not replace precise code behavior with vague analogy.
• Do not over-explain basics when the user's context shows expertise.

Layers

Use only the layers needed:

• Overview
• Execution flow
• Role of each important block
• Inputs and outputs
• Side effects
• Possible errors
• Concrete example

Rules

• Keep identifiers exact.
• Mention assumptions explicitly.
• Point to exact files and functions when available.
• Explain jargon when it matters for understanding.