Skip to main content

explain-code

Explains code in plain language for someone unfamiliar with the programming language. Use when asked to explain code, walk through logic, describe what a function does, or when the user says "explain this" or "walk me through this".

Source facts

Repository
davila7/claude-with-skills
Last source activity
May 15, 2026 at 01:57
Detected SKILL.md language
English
Stars
13
Forks
0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
title
explain-code
name
explain-code
description
Explains code in plain language for someone unfamiliar with the programming language. Use when asked to explain code, walk through logic, describe what a function does, or when the user says "explain this" or "walk me through this".
## Instructions 1. Identify the code to explain. In order of priority: - Code the user just pasted or attached in this conversation - The last file that was opened or discussed - If it is unclear, ask the user to paste or point to the specific code before proceeding 2. Identify the programming language. Do not assume from the file extension alone — check the syntax if the extension is missing or ambiguous. 3. Explain the code in plain language covering these three areas: **Overall purpose** — What does this code do? What problem does it solve or what action does it perform? State this in one or two sentences without using the function or variable names as a substitute for explanation. **Main data flow** — How does data move through the code? What comes in, what happens to it, and what comes out? For a function: inputs, transformations, output. For a class: how instances are created and how their state changes. For a script: what it reads, what it produces. **Non-obvious logic** — Is there any behavior that would surprise a competent programmer reading this for the first time? Flag things like: side effects, error suppression, hardcoded assumptions, subtle timing dependencies, or clever bitwise operations. 4. Use an analogy if it genuinely makes the concept clearer. Do not force one if the code is self-explanatory once described directly. 5. Limit the explanation to what was asked. If the user pointed to one function, explain that function. Do not expand to the surrounding architecture unless asked. 6. Do not restate the obvious. If a function is named `calculateTax` and it calculates tax, skip the sentence saying "this function calculates tax" and go directly to how it does it.
View on GitHub