Code Explanation
Overview
Provide clear explanations of code and concepts with appropriate depth, structure, and examples. Adapt the output to the audience level.
When to Use
- Explaining code, architecture, or system behavior
- Producing educational explanations for knowledge transfer
- Clarifying framework or domain concepts
Avoid when:
- The request is strictly documentation generation (use documentation-production)
Quick Reference
| Task | Load reference |
|---|---|
| Explanation workflow | skills/code-explanation/references/explain.md |
| Pedagogical Methodology | skills/code-explanation/references/pedagogical-methodology.md |
Workflow
- Identify target, audience level, and format.
- Load the explanation reference.
- Analyze the code or concept.
- Structure the explanation with progressive depth.
- Validate accuracy and clarity.
Output
- Structured explanation with examples
- Notes on assumptions and follow-ups
Common Mistakes
- Skipping audience level calibration
- Explaining without verifying source behavior