# Explain

> Explain code with diagrams Use when this capability is needed.

- Skill: `tomevault-io/explain-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/explain-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/explain-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/explain-2

---


# /explain Skill

Explain code clearly with structured breakdowns.

## Usage
- `/explain src/auth/middleware.ts` — explain a file
- `/explain handleAuth` — explain a function
- `/explain` — explain the current context / recent changes

## Steps

1. Read the target file or find the target function
2. Identify the purpose and context (what system it's part of)
3. Break down the logic step by step
4. Identify key patterns and design decisions
5. Note any dependencies or side effects

## Output Format

### Overview
One paragraph explaining what this code does and why it exists.

### How It Works
Step-by-step walkthrough of the logic, referencing line numbers.

### Key Concepts
- Important patterns or abstractions used
- Non-obvious design decisions

### Data Flow
Describe how data enters, transforms, and exits.

### Dependencies
- What this code depends on
- What depends on this code

### Gotchas
- Edge cases to be aware of
- Common mistakes when modifying this code

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/xeldaralz) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->