explain-code
Explain what code does, clearly and at the right level.
SKILL.mdskills/explain-code/SKILL.md
GitHubWhen to use
The user asks "what does this do / how does it work" about a file or function.
How
read_fileit first.- Give a one-sentence summary of its purpose, then walk inputs → key logic → outputs.
- Call out the surprising or risky bits (edge cases, side effects) — not the obvious lines.
- Tie every point to the actual code.
Avoid
- Generic theory not tied to the code in front of you.
- Narrating every line; focus on what matters.
- Editing the file unless asked.
Done well
Someone unfamiliar understands what the code does and why, plus the gotchas — in a couple of short paragraphs.