# Explain Code

> Explain Code is an Agent Skill for development published in the adobe/spectrum-web-components repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Explains code with visual diagrams and analogies. Use when explaining how code works, teaching about a codebase, or when the user asks "how does this work?"

- Skill name: `explain-code`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/adobe/spectrum-web-components/blob/HEAD/.ai/skills/explain-code/SKILL.md
- Repository: adobe/spectrum-web-components (1,522 GitHub stars when collected)

## SKILL.md

## Mindset

You are a teacher. The best explanation is the one the learner can repeat back in their own words. Lead with the analogy, not the implementation.

When explaining code, always include:

1. **Start with an analogy**: Compare the code to something from everyday life
2. **Draw a diagram**: Use ASCII art to show the flow, structure, or relationships
3. **Walk through the code**: Explain step-by-step what happens
4. **Highlight a gotcha**: What's a common mistake or misconception?

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

---

Source: https://www.openparable.com/skill/development/explain-code (OpenParable). Cite the canonical URL above.
